Question 1

How to format bytes with custom precision using Byte Units?

Accepted Answer

Use the format method with precision specifiers, like 'MB/6' for six decimal places or '000000' for zero-padded precision. For example, ByteUnits\bytes(1322123)->format('MB/6') outputs '1.322123MB'. This allows fine-grained control over display.

Question 2

Byte Units vs PHP's native filesize function: which is better?

Accepted Answer

Byte Units is superior for handling multiple unit systems and advanced operations, while PHP's filesize returns bytes only. Use Byte Units for parsing mixed inputs (e.g., '1.5MB') and arithmetic; native functions suffice for simple byte retrieval without conversions.

Question 3

Can Byte Units automatically detect metric or binary from a string?

Accepted Answer

Yes, the parse function auto-detects the system based on suffixes (kB for metric, KiB for binary). However, you can enforce a system with Metric::parse or Binary::parse to avoid ambiguity, but mismatches throw exceptions.

Question 4

How to handle negative bytes in Byte Units?

Accepted Answer

Negative bytes are not allowed; arithmetic that would result in negative values throws a NegativeBytesException. You must ensure operations like remove() don't go below zero, requiring checks in your code to prevent errors.

Question 5

Is Byte Units compatible with PHP 8 or newer versions?

Accepted Answer

The README doesn't specify, but as a Composer package, it likely supports modern PHP if maintained. Check the GitHub repository or Composer metadata for version constraints, as pre-1.0 libraries might lag behind PHP updates.

Question 6

What are good alternatives to Byte Units for PHP byte handling?

Accepted Answer

Alternatives include PHP's built-in functions for basic needs or libraries like 'php-units' for broader measurement support. Byte Units is best for byte-specific clarity; choose based on whether you need dual systems or general unit conversions.

Question 7

How to convert between metric and binary systems with Byte Units?

Accepted Answer

Use the asMetric() or asBinary() methods on objects. For example, ByteUnits\Binary::bytes(1024)->asMetric()->format() converts 1KiB to approximately 1.02kB. This preserves precision during cross-system conversions.

ByteUnits

What is ByteUnits?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions