function file_validate_size

Same name and namespace in other branches
  1. 7.x includes/file.inc \file_validate_size()
  2. 9 core/modules/file/file.module \file_validate_size()
  3. 10 core/modules/file/file.module \file_validate_size()

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

Parameters

\Drupal\file\FileInterface $file: A file entity.

int $file_limit: (optional) The maximum file size in bytes. Zero (the default) indicates that no limit should be enforced.

int $user_limit: (optional) The maximum number of bytes the user is allowed. Zero (the default) indicates that no limit should be enforced.

Return value

array An empty array if the file size is below limits or an array containing an error message if it's not.

See also

hook_file_validate()

1 call to file_validate_size()
ValidatorTest::testFileValidateSize in core/modules/file/tests/src/Kernel/ValidatorTest.php
Test file_validate_size().

File

core/modules/file/file.module, line 411

Code

function file_validate_size(FileInterface $file, $file_limit = 0, $user_limit = 0) {
    $user = \Drupal::currentUser();
    $errors = [];
    if ($file_limit && $file->getSize() > $file_limit) {
        $errors[] = t('The file is %filesize exceeding the maximum file size of %maxsize.', [
            '%filesize' => format_size($file->getSize()),
            '%maxsize' => format_size($file_limit),
        ]);
    }
    // Save a query by only calling spaceUsed() when a limit is provided.
    if ($user_limit && \Drupal::entityTypeManager()->getStorage('file')
        ->spaceUsed($user->id()) + $file->getSize() > $user_limit) {
        $errors[] = t('The file is %filesize which would exceed your disk quota of %quota.', [
            '%filesize' => format_size($file->getSize()),
            '%quota' => format_size($user_limit),
        ]);
    }
    return $errors;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.