1. <?php
  3. /**
  4. * Data Validation Functions for Staging Environments
  5. * Minimal Dependencies
  6. */
  8. /**
  9. * Validates email address format.
  10. *
  11. * @param string $email The email address to validate.
  12. * @return bool True if the email is valid, false otherwise.
  13. */
  14. function validateEmail(string $email): bool
  15. {
  16. return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
  17. }
  19. /**
  20. * Validates string length.
  21. *
  22. * @param string $string The string to validate.
  23. * @param int $minLength The minimum length of the string.
  24. * @param int $maxLength The maximum length of the string.
  25. * @return bool True if the string is within the specified length, false otherwise.
  26. */
  27. function validateStringLength(string $string, int $minLength, int $maxLength): bool
  28. {
  29. return strlen($string) >= $minLength && strlen($string) <= $maxLength;
  30. }
  32. /**
  33. * Validates numeric value.
  34. *
  35. * @param mixed $value The value to validate.
  36. * @param float|int $min The minimum allowed value.
  37. * @param float|int $max The maximum allowed value.
  38. * @return bool True if the value is a number within the range, false otherwise.
  39. */
  40. function validateNumeric(mixed $value, float|int $min, float|int $max): bool
  41. {
  42. if (!is_numeric($value)) {
  43. return false;
  44. }
  45. return $value >= $min && $value <= $max;
  46. }
  48. /**
  49. * Validates an array of data.
  50. *
  51. * @param array $data The array of data to validate.
  52. * @param array $rules An associative array defining validation rules.
  53. * Example: ['field1' => 'required|string:50', 'field2' => 'numeric:0-100']
  54. * @return array An associative array containing validation errors. Empty array if valid.
  55. */
  56. function validateData(array $data, array $rules): array
  57. {
  58. $errors = [];
  60. foreach ($rules as $field => $rule) {
  61. if (!isset($data[$field])) {
  62. if ($rule === 'required') {
  63. $errors[$field] = 'This field is required.';
  64. }
  65. } else {
  66. switch ($rule) {
  67. case 'required':
  68. if (empty($data[$field])) {
  69. $errors[$field] = 'This field is required.';
  70. }
  71. break;
  72. case 'string':
  73. if (!is_string($data[$field])) {
  74. $errors[$field] = 'This field must be a string.';
  75. } else {
  76. $length = (int)substr($rule, strpos($rule, ':') + 1);
  77. if (!validateStringLength($data[$field], 1, $length)) {
  78. $errors[$field] = 'This field must be between ' . $minLength . ' and ' . $maxLength . ' characters.';
  79. }
  80. }
  81. break;
  82. case 'numeric':
  83. $range = explode('-', substr($rule, strpos($rule, ':') + 1));
  84. if (!is_numeric($data[$field])) {
  85. $errors[$field] = 'This field must be a number.';
  86. } else {
  87. $min = (float)$range[0];
  88. $max = (float)$range[1];
  89. if (!validateNumeric($data[$field], $min, $max)) {
  90. $errors[$field] = 'This field must be between ' . $min . ' and ' . $max . '.';
  91. }
  92. }
  93. break;
  94. case 'email':
  95. if (!validateEmail($data[$field])) {
  96. $errors[$field] = 'This field must be a valid email address.';
  97. }
  98. break;
  99. default:
  100. $errors[$field] = 'Invalid validation rule: ' . $rule;
  101. }
  102. }
  103. }
  105. return $errors;
  106. }
  108. //Example Usage
  109. /*
  110. $data = [
  111. 'name' => 'John Doe',
  112. 'email' => 'john.doe@example.com',
  113. 'age' => 30,
  114. 'city' => 'New York',
  115. 'zip' => 10001
  116. ];
  118. $rules = [
  119. 'name' => 'required|string:50',
  120. 'email' => 'required|

Add your comment