deblan-mirror/respect-validation
deblan-mirror/respect-validation
1
0
Fork 0
mirror of https://github.com/Respect/Validation.git synced 2026-03-15 23:05:45 +01:00
Code Issues Projects Releases Packages Wiki Activity
respect-validation/docs/validators/Size.md
Alexandre Gomes Gaigalas bd48bdcda4 Lint Changelog format in validator docs 
Introduces a Markdown linter for checking the Changelog format.

"See Also" was transformed into a section to make it easier to
handle it with the `Content` class. The "Related" linter was
simplified to reflect that change too.

An additional "alignment" parameter was added to markdown table
generators, allowing the padding and headers to be explicitly
marked with a specific left (-1), middle (0) or right(1)
alignment.

Existing files were fixed using the `fix` option after the
changes.
2026-01-26 19:11:00 +00:00

3 KiB
Raw Blame History

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

Mode Template
default The size in {{unit|trans}} of
inverted The size in {{unit|trans}} of

Size::TEMPLATE_WRONG_TYPE

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

Mode Template
default {{subject}} must be a filename or an instance of SplFileInfo or a PSR-7 interface
inverted {{subject}} must not be a filename or an instance of SplFileInfo 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

Placeholder Description
subject The validated input or the custom validator name (if specified).
unit The name of the storage unit (bytes, kilobytes, etc.)

Categorization

  • File system
  • Transformations

Changelog

Version Description
3.0.0 Became a transformation
2.1.0 Add PSR-7 support
1.0.0 Created

See Also