function file_validate_size

7.x file.inc file_validate_size(stdClass $file, $file_limit = 0, $user_limit = 0)
6.x file.inc file_validate_size($file, $file_limit = 0, $user_limit = 0)

Checks that the file's size is below certain limits.

This check is not enforced for the user #1.

Parameters

$file: A Drupal file object.

$file_limit: An integer specifying the maximum file size in bytes. Zero indicates that no limit should be enforced.

$user_limit: An integer specifying the maximum number of bytes the user is allowed. Zero indicates that no limit should be enforced.

Return value

An array. If the file size exceeds limits, it will contain an error message.

See also

hook_file_validate()

Related topics

File interface
Common file handling functions.
1 call to file_validate_size()
FileValidatorTest::testFileValidateSize in drupal-7.x/modules/simpletest/tests/file.test
Test file_validate_size().
3 string references to 'file_validate_size'
file_field_widget_upload_validators in drupal-7.x/modules/file/file.field.inc
Retrieves the upload validators for a file field.
theme_file_upload_help in drupal-7.x/modules/file/file.field.inc
Returns HTML for help text based on file upload validators.
user_validate_picture in drupal-7.x/modules/user/user.module
Validates an image uploaded by a user.

File

drupal-7.x/includes/file.inc, line 1744
API for handling file uploads and server file management.

Code

function file_validate_size(stdClass $file, $file_limit = 0, $user_limit = 0) {
  global $user;

  $errors = array();

  // Bypass validation for uid  = 1.
  if ($user->uid != 1) {
    if ($file_limit && $file->filesize > $file_limit) {
      $errors[] = t('The file is %filesize exceeding the maximum file size of %maxsize.', array('%filesize' => format_size($file->filesize), '%maxsize' => format_size($file_limit)));
    }

    // Save a query by only calling file_space_used() when a limit is provided.
    if ($user_limit && (file_space_used($user->uid) + $file->filesize) > $user_limit) {
      $errors[] = t('The file is %filesize which would exceed your disk quota of %quota.', array('%filesize' => format_size($file->filesize), '%quota' => format_size($user_limit)));
    }
  }
  return $errors;
}