1. <?php
  3. /**
  4. * Extends header metadata validation with optional flags.
  5. *
  6. * @param array $headers Array of HTTP headers.
  7. * @param array $validation_rules Associative array of validation rules. Key is header name, value is an array of rules (e.g., ['required' => true, 'type' => 'string', 'min_length' => 5]).
  8. * @param array $flags Optional array of flags to apply to specific headers. Key is header name, value is an array of flags (e.g., ['allow_empty' => true, 'regex' => '/^[a-zA-Z0-9]+$/']).
  9. * @return array|false Modified headers array if validation passes, false on failure.
  10. */
  11. function validateHeaders(array $headers, array $validation_rules, array $flags = []): array|false
  12. {
  13. $validated_headers = [];
  15. foreach ($validation_rules as $header_name => $rules) {
  16. if (!isset($headers[$header_name])) {
  17. if (isset($rules['required']) && $rules['required'] === true) {
  18. error_log("Header missing: " . $header_name); // Log the missing header
  19. return false; // Validation failed
  20. }
  21. continue; // Skip validation if not required and header is missing
  22. }
  24. $header_value = trim($headers[$header_name]); // Trim whitespace
  26. foreach ($rules as $rule_name => $rule_value) {
  27. switch ($rule_name) {
  28. case 'required':
  29. if ($rule_value === true && empty($header_value)) {
  30. error_log("Header '" . $header_name . "' is required but empty.");
  31. return false;
  32. }
  33. break;
  34. case 'type':
  35. switch ($rule_value) {
  36. case 'string':
  37. if (!is_string($header_value)) {
  38. error_log("Header '" . $header_name . "' must be a string.");
  39. return false;
  40. }
  41. break;
  42. case 'integer':
  43. if (!is_int($header_value)) {
  44. error_log("Header '" . $header_name . "' must be an integer.");
  45. return false;
  46. }
  47. break;
  48. case 'boolean':
  49. if ($header_value !== 'true' && $header_value !== 'false') {
  50. error_log("Header '" . $header_name . "' must be a boolean (true/false).");
  51. return false;
  52. }
  53. break;
  54. default:
  55. error_log("Unsupported type: " . $rule_value);
  56. return false;
  57. }
  58. break;
  59. case 'min_length':
  60. if (strlen($header_value) < $rule_value) {
  61. error_log("Header '" . $header_name . "' must be at least " . $rule_value . " characters long.");
  62. return false;
  63. }
  64. break;
  65. case 'max_length':
  66. if (strlen($header_value) > $rule_value) {
  67. error_log("Header '" . $header_name . "' must be at most " . $rule_value . " characters long.");
  68. return false;
  69. }
  70. break;
  71. case 'regex':
  72. if (!preg_match($rule_value, $header_value)) {
  73. error_log("Header '" . $header_name . "' does not match regex: " . $rule_value);
  74. return false;
  75. }
  76. break;
  77. case 'allow_empty':
  78. if ($rule_value === false && empty($header_value)) {
  79. error_log("Header '" . $header_name . "' must not be empty.");
  80. return false;
  81. }
  82. break;
  83. default:
  84. error_log("Unknown validation rule: " . $rule_name);
  85. return false;
  86. }
  87. }
  89. $validated_headers[$header_name] = $header_value;
  90. }
  92. return $validated_headers;
  93. }
  96. ?>

Add your comment