Size

• Size("B"|"KB"|"MB"|"GB"|"TB"|"PB"|"EB"|"ZB"|"YB" $unit, Validator $validator)

Validates whether the input is a file that is of a certain size or not.

v::size('KB', v::greaterThan(1))->assert('/path/to/file');
// Validation passes successfully

v::size('MB', v::between(1, 2))->assert('/path/to/file');
// → The size in megabytes of "/path/to/file" must be between 1 and 2

v::size('GB', v::lessThan(1))->assert('/path/to/file');
// Validation passes successfully

Accepted data storage units are B, KB, MB, GB, TB, PB, EB, ZB, and YB.

This validator will accept:

• string file paths
• SplFileInfo objects (see SplFileInfo)
• Psr\Http\Message\UploadedFileInterface objects (see PSR-7)
• Psr\Http\Message\StreamInterface objects (see PSR-7)

Templates

Size::TEMPLATE_STANDARD

Size::TEMPLATE_WRONG_TYPE

Used when the input is not a valid file path, a SplFileInfo object, or a PSR-7 interface.

Template as prefix

The template serves as a prefix to the template of the inner validator.

v::size('MB', v::equals(2))->assert('/path/to/file');
// → The size in megabytes of "/path/to/file" must be equal to 2

v::size('KB', v::not(v::equals(56)))->assert('/path/to/file');
// Validation passes successfully

Template placeholders

Categorization

• File system
• Transformations

Changelog

See Also

• Directory
• Executable
• Exists
• Extension
• File
• Image
• Mimetype
• Readable
• SymbolicLink
• Writable