Download the PHP package nabeghe/file-size without Composer
On this page you can find all versions of the php package nabeghe/file-size. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package file-size
FileSize Helper for PHP ≥ 7.4
A simple, handy PHP library to work with file sizes and units.
Convert, compare, parse, and format sizes in bytes, bits, kilobytes, megabytes... you name it.
Supports bits and bytes, plus all common units up to yottabytes.
Features
- Convert sizes between any units (e.g. MB → GB, bits → bytes)
- Generate human-readable size strings from raw values or unit-based input
- Parse human-readable strings like
"1.5 GB"or"200 Kb" - Auto-detect the best unit for a given raw size (e.g. 1536000 → MB)
- Format numbers cleanly with optional decimal precision
- Compare two sizes across different units
- Get percentage relations between sizes
- Validate units easily (
B,KB,Mb,Gb, etc.) - Customize unit labels for flexible display
Supported Units
- Bytes:
B, KB, MB, GB, TB, PB, EB, ZB, YB - Bits:
b, Kb, Mb, Gb, Tb, Pb, Eb, Zb, Yb
🫡 Usage
🚀 Installation
You can install the package via composer:
Or manually include the FileSize.php if you want to keep it old school.
Examples
First:
Get a list of all supported units
Syntax: getAllUnits(bool $bits = false): array
Check if a unit is supported
Syntax: isValidUnit(string $unit): bool
Clean up a number to a fixed decimal format
Syntax: format(float|int $size, int $decimals = 2): int|float
Convert between units
Syntax: convert($size, $fromUnit, $toUnit, $format = false, $isBinary = true)
Compare two sizes, even if in different units
Syntax: compare($size1, $unit1, $size2, $unit2): int
Find the best-fit unit for a byte size
Syntax: detectUnit($size, $isBits = false, &$finalSize = null, bool $isBinary = true: string
Turn a byte or bit size into a human-readable string
Syntax: readable($size, $isBits = false, $labels = [])
Convert a size from a specific unit and make it readable
Syntax: readableFromUnit($size, $unit, $labels = [], bool $isBinary = true)
Extract numeric value and unit from a string
Syntax: parse(string $input): array
Calculate how much size1 is of size2 in %
Syntax: percentage($size1, $unit1, $size2, $unit2, bool $isBinary = true): float
📖 License
Licensed under the MIT license, see LICENSE.md for details.