This FieldType represents and handles a binary file. It also counts the number of times the file has been downloaded from the
|Name||Internal name||Expected input||Output|
Table of contents:
FieldType allows the storage and retrieval of a single file. It is capable of handling virtually any file type and is typically used for storing legacy document types such as PDF files, Word documents, spreadsheets, etc. The maximum allowed file size is determined by the "Max file size" class attribute edit parameter and the "
upload_max_filesize" directive in the main PHP configuration file ("php.ini").
BinaryFile Value Object API
eZ\Publish\Core\FieldType\BinaryFile\Value offers the following properties.
Note that both
BinaryFile and Media Value and Type inherit from the
BinaryBase abstract field type, and share common properties.
|string||Binary file identifier. This ID depends on the IO Handler that is being used. With the native, default handlers (FileSystem and Legacy), the ID is the file path, relative to the binary file storage root dir (||application/63cd472dd7819da7b75e8e2fee507c68.pdf|
|string||The human readable file name, as exposed to the outside. Used when sending the file for download in order to name the file.||20130116_whitepaper_ezpublish5 light.pdf|
|int||File size, in bytes||1077923|
|string||The file's mime type.||application/pdf|
The binary file's HTTP uri. If the URI doesn't include a host or protocol, it applies to the request domain. This attribute has been introduced in eZ Publish 5.2.
The URI is not publicly readable, and must NOT be used to link to the file for download. Use
Since v5.4 the property contains the binary file's content/download URL.
|integer||Number of times the file was downloaded||0|
BinaryFile hash format
The hash format mostly matches the value object. It has the following keys:
path(for backwards compatibility)
REST API specifics
Used in the REST API, a BinaryFile field will mostly serialize the hash described above. However there are a couple specifics worth mentioning.
Reading content: url property
When reading the contents of a field of this type, an extra key is added: url. This key gives you the absolute file URL, protocol and host included.
Creating content: data property
When creating BinaryFile content with the REST API, it is possible to provide data as a base64 encoded string, using the "
data" fieldValue key: