Class Size.
The Size class provides utility methods for calculating file sizes
in bytes from different types of inputs, such as strings, files, and
resources. It supports both multibyte and single-byte character encodings,
ensuring accurate size calculations even for various types of content.
This class is useful for applications that need to handle and manipulate
file sizes efficiently.
fromContent(string $content) : int
Returns the size in bytes of the given content.
This method calculates the byte size of a string. If the mbstring
extension is loaded, it uses mb_strlen with the '8bit' encoding
to ensure accurate byte measurement for multibyte characters.
Otherwise, it falls back to strlen.
| string | $content | The content whose size is to be calculated. |
The size of the content in bytes.
fromFile(string $filename) : int
Returns the size in bytes of the given file.
This method retrieves the size of a file specified by its filename. If the file does not exist or an error occurs, it returns false.
| string | $filename | The path to the file whose size is to be calculated. |
if the file does not exist.
The size of the file in bytes.
fromResource(resource $handle) : string|int
Returns the size in bytes from the given resource.
This method calculates the size of a resource using fstat. If the
resource points to a remote file, the size will be returned as 0.
It handles both local and remote resources effectively.
| resource | $handle | The resource whose size is to be calculated. |
The size of the resource in bytes, or 0 if the size is unavailable.