1. <?php
  3. /**
  4. * Checks collection constraints for backward compatibility in dry-run mode.
  5. *
  6. * @param array $collection The collection to check.
  7. * @param array $constraints An array of constraint definitions. Each constraint should be an associative array
  8. * with keys: 'name' (string), 'type' (string, e.g., 'int', 'string', 'array'),
  9. * 'min' (int, optional), 'max' (int, optional), 'allowed_values' (array, optional).
  10. * @param bool $dry_run Whether to perform a dry run (no actual changes). Defaults to true.
  11. * @return array An array of constraint violations. Each element is an associative array with
  12. * keys: 'name' (string), 'message' (string). Returns an empty array if no violations.
  13. */
  14. function checkCollectionConstraints(array $collection, array $constraints, bool $dry_run = true): array
  15. {
  16. $violations = [];
  18. foreach ($constraints as $constraint) {
  19. $name = $constraint['name'];
  20. $type = $constraint['type'];
  22. switch ($type) {
  23. case 'int':
  24. if (!is_int($collection[$name])) {
  25. $violations[] = ['name' => $name, 'message' => "Expected integer, got " . gettype($collection[$name])];
  26. }
  27. if (isset($constraint['min']) && $collection[$name] < $constraint['min']) {
  28. $violations[] = ['name' => $name, 'message' => "Must be at least " . $constraint['min']];
  29. }
  30. if (isset($constraint['max']) && $collection[$name] > $constraint['max']) {
  31. $violations[] = ['name' => $name, 'message' => "Must be at most " . $constraint['max']];
  32. }
  33. break;
  34. case 'string':
  35. if (!is_string($collection[$name])) {
  36. $violations[] = ['name' => $name, 'message' => "Expected string, got " . gettype($collection[$name])];
  37. }
  38. if (isset($constraint['min_length']) && strlen($collection[$name]) < $constraint['min_length']) {
  39. $violations[] = ['name' => $name, 'message' => "Must be at least " . $constraint['min_length'] . " characters long"];
  40. }
  41. if (isset($constraint['max_length']) && strlen($collection[$name]) > $constraint['max_length']) {
  42. $violations[] = ['name' => $name, 'message' => "Must be at most " . $constraint['max_length'] . " characters long"];
  43. }
  44. break;
  45. case 'array':
  46. if (!is_array($collection[$name])) {
  47. $violations[] = ['name' => $name, 'message' => "Expected array, got " . gettype($collection[$name])];
  48. }
  49. if (isset($constraint['allowed_values'])) {
  50. $allowedValues = $constraint['allowed_values'];
  51. $valid = true;
  52. foreach ($collection[$name] as $item) {
  53. if (!in_array($item, $allowedValues)) {
  54. $valid = false;
  55. break;
  56. }
  57. }
  58. if (!$valid) {
  59. $violations[] = ['name' => $name, 'message' => "Array must contain only values from: " . implode(', ', $allowedValues)];
  60. }
  61. }
  62. break;
  63. default:
  64. // Unknown type - log a warning or handle as needed
  65. error_log("Unknown constraint type: " . $type);
  66. break;
  67. }
  68. }
  70. return $violations;
  71. }
  73. //Example usage (dry run)
  74. $collection = [
  75. 'age' => 30,
  76. 'name' => 'John Doe',
  77. 'tags' => ['tag1', 'tag2', 'invalid_tag'],
  78. 'score' => 150
  79. ];
  81. $constraints = [
  82. ['name' => 'age', 'type' => 'int', 'min' => 18, 'max' => 100],
  83. ['name' => 'name', 'type' => 'string', 'min_length' => 3, 'max_length' => 20],
  84. ['name' => 'tags', 'type'

Add your comment