The Media Field Type

Written by Petar Spanja Updated 01/28/2016 by Dominika Kurek

This Field Type represents and handles media (audio/video) binary file.

Name	Internal name	Expected input
Media	ezmedia	mixed

Table of contents:

Description

This Field Type represents and handles a media (audio/video) binary file.

It is capable of handling following types of files:

Type	Description	Example
string	Path to the media file.	/Users/jane/butterflies.mp4
eZ\Publish\Core\FieldType\Media\Value	Media FieldType Value Object with path to the media file as the value of id property.	See Value object section below.

eZ\Publish\Core\FieldType\Media\Value offers the following properties.

Note that both Media and BinaryFile Value and Type inherit from the BinaryBase abstract Field Type and share common properties.

Property	Type	Description	Example
id	string	Media 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 (var/<vardir>/storage/original by default).	application/63cd472dd7819da7b75e8e2fee507c68.mp4
fileName	string	The human-readable file name, as exposed to the outside. Used when sending the file for download in order to name the file.	butterflies.mp4
fileSize	int	File size, in bytes.	1077923
mimeType	string	The file's mime type.	video/mp4
uri	string	The binary file's HTTP uri. If the URI doesn't include a host or protocol, it applies to the request domain. The URI is not publicly readable, and must NOT be used to link to the file for download. Use ez_render_field to generate a valid link to the download controller.	/var/ezdemo_site/storage/original/application/63cd472dd7819da7b75e8e2fee507c68.mp4
hasController	boolean	Whether the media has a controller when being displayed.	true
autoplay	boolean	Whether the media should be automatically played.	true
loop	boolean	Whether the media should be played in a loop.	false
height	int	Height of the media.	300
width	int	Width of the media.	400
path	string	deprecated Renamed to id starting from Exponential 5.2. Can still be used, but it is recommended not to use it anymore as it will be removed.

The hash format mostly matches the value object. It has the following keys:

The Field Type supports FileSizeValidator, defining maximum size of media file in bytes:

Name	Type	Default value	Description
maxFileSize	int	false	Maximum size of the file in bytes.

Example of using Media Field Type validator in PHP

The Field Type supports mediaType setting, defining how the media file should be handled in output.

Name	Type	Default value	Description
mediaType	mixed	Type::TYPE_HTML5_VIDEO	Type of the media, accepts one of the predefined constants.

List of all available mediaType constants defined in eZ\Publish\Core\FieldType\Media\Type class: