mm

xx xx xx xx x x x x x x x x x x -- The PHP media library.

Synopsis

Making media processing portable isn't easy. Retrieving meta data from media through one of the thousand extensions is by times overwhelming. Dealing with MIME-types is most often limited to magic lookup.

This library is concerned with three aspects of media and organized accordingly:

• Processing of media
• Retrieving media metadata
• Determining a file's MIME-type

The set of \mm\Media* classes provide abstractions from underlying extensions or libraries and most common methods for operations like resizing and conversion (even between i.e. PDFs, movies and images).

The \mm\Mime\Type class helps with determining the MIME-type or correct extension of a file or stream. It comes with adapters for the fileinfo extension, glob and magic databases from the freedesktop project, as well as modmime style databases.

The files required to make MIME detection work autonomously (i.e. without the fileinfo extension installed) are shipped with the library. You'll find those files in the data directory. Please note that the MIME magic implementation in pure PHP will always be a lot slower than the PHP extensions in C and currently has to be considered experimental.

Features

The most significant features of this library are:

• Full suit of unit and integration tests
• Battle tested and used in production since over 6 years
• PSR-0 and PSR-4 compatiblity
• Fast Freedesktop glob file parser implemented in pure PHP
• FFmpeg and SoX adapters for video and audio conversion

Copyright & License

MM, the PHP media library is Copyright (c) 2007 David Persson if not otherwise stated. The code is distributed under the terms of the MIT License. For the full license text see the LICENSE file.

Requirements

The library is known to run fine under linux and darwin. Depending on the adapters you are using you may need (this is a selection):

• ext/fileinfo
• ext/gd
• ghostscript
• ImageMagick
• ext/imagick >= 3.0.0
• FFmpeg >= 0.10.0, < 0.11.0
• SoX

Installation

The preferred installation method is via composer. You can add the library as a dependency via:

$ composer require davidpersson/mm

To bootstrap and pre-configure the library load the bootstrap file:

require /path/to/mm/bootstrap.php

Quickstart: MIME-type Detection

Before we can use any of the classes we must configure them. The following is just a minimal example. Have a look at the included bootstrap.php for more information what's possible.

More documentation for MIME-type detection is available in the docs subdirectory.

Guess the MIME type of the file.

Guess the extension (suffix) for an existing file or a MIME type.

Determine the common lowercase media name, with and without hints from a magic lookup.

Quickstart: Media Processing

First we configure the class.

A common task is to convert an image into another format, apply some compression while ensuring it has the sRGB profile embbeded. We'll utilize the factory method here which handles MIME-type detection of the source file for us and returns an appropriate \mm\Media\Process* class for us.

Using the Ffmpeg adapter we can transcode videos programmatically. Using the passthru method we can access the adapter more or less directly.

Quickstart: Media Information

First we configure the class.

Getting information from an image. Information is assembled by all configured adapters for the type.

Running the Tests

This library is continously integrated. Please check the following URL for information on the status of the latest builds:

http://travis-ci.org/#!/davidpersson/mm

Tests for this library are PHPUnit based. To run the tests you'll need to have PHPUnit installed[1]. Following command will run all the tests.

$ phpunit

[1] http://www.phpunit.de/manual/current/en/installation.html

Documentation

Documentation is available in the docs directory.