file_validate

  1. drupal
    1. 8
    2. 7
Versions
7 – 8 file_validate(stdClass &$file, $validators = array())

Check that a file meets the criteria specified by the validators.

After executing the validator callbacks specified hook_file_validate() will also be called to allow other modules to report errors about the file.

Parameters

$file A Drupal file object.

$validators An optional, associative array of callback functions used to validate the file. The keys are function names and the values arrays of callback parameters which will be passed in after the file object. The functions should return an array of error messages; an empty array indicates that the file passed validation. The functions will be called in the order specified.

Return value

An array containing validation error messages.

See also

hook_file_validate()

Related topics

▾ 2 functions call file_validate()

FileValidateTest::testCallerValidation in modules/simpletest/tests/file.test
Test that the validators passed into are checked.
file_save_upload in includes/file.inc
Saves a file upload to a new location.

Code

includes/file.inc, line 1627

<?php
function file_validate(stdClass &$file, $validators = array()) {
  // Call the validation functions specified by this function's caller.
  $errors = array();
  foreach ($validators as $function => $args) {
    if (function_exists($function)) {
      array_unshift($args, $file);
      $errors = array_merge($errors, call_user_func_array($function, $args));
    }
  }

  // Let other modules perform validation on the new file.
  return array_merge($errors, module_invoke_all('file_validate', $file));
}
?>