Path to file command - empty string disables the use of the file command

   ['i'] => null // this option asks file to produce a MIME type if it can
   ['b'] => null // this option tells file to be brief
 

Constructor

Optional parameter can be either a string containing the path to the mime.types files, or an associative array holding the extension as key and the MIME type as value.

Example:

1        $mime =& new Mime_Types('/usr/local/apache/conf/mime.types');

or

1        $mime =& new Mime_Types(array(
2             'application/pdf'        => 'pdf',
3             'application/postscript' => array('ai','eps')
4             ));

• mixed $mime_types

1        $ext = $mime->get_extension('application/postscript');
2        if ($ext) echo $ext;

Get extensions - returns array containing extension(s)

Example:

1        $exts = $mime->get_extensions('application/postscript');
2        echo implode(', ', $exts);

• string $type

1        echo $mime->get_file_type('/path/to/my_file', false);

1        echo $mime->get_file_type('/path/to/my_file.gif');

Get type - returns MIME type based on the file extension

Example:

1        echo $mime->get_type('txt');

or

1        echo $mime->get_type('test_file.txt');

both examples above will return the same result.

• return:

  false if extension not found

• string $ext

1        if ($mime->has_extension('pdf')) echo 'Got it!';

Has type

Returns true if type $type exists, false otherwise

Example:

1        if ($mime->has_type('image/gif')) echo 'Got it!';

• string $type

1        $result = $mime->load_file('/usr/local/apache/conf/mime.types');
2        echo (($result) ? 'Success!' : 'Failed');

Remove extension

Example:

1        $mime->remove_extension('txt');

or

1        $mime->remove_extension('txt exe html');

or

1        $mime->remove_extension(array('txt', 'exe', 'html'));

• mixed $exts:

  string holding extension(s) seperated by space, or array

1        $mime->remove_type('text/plain');

1        $mime->remove_type('image/*');
2        

1        $mime->remove_type();
2        

Scan

Goes through all MIME types passing the extension and type to the callback function. The types will be sent in alphabetical order. If a type has multiple extensions, each extension will be passed seperately (not as an array).

The callback function can be a method from another object (eg. array(&$my_obj, 'my_method')). The callback function should accept 3 arguments:

1. A reference to the Mime_Types object (&$mime)
2. An array holding extension and type, array keys: [0]=>ext, [1]=>type
3. An optional parameter which can be used for whatever your function wants :), even though you might not have a use for this parameter, you need to define your function to accept it. (Note: you can have this parameter be passed by reference)

The callback function should return a boolean, a value of 'true' will tell scan() you want it to continue with the rest of the types, 'false' will tell scan() to stop calling your callback function.

• mixed $callback:

  function name, or array holding an object and the method to call.

• mixed $param:

  passed as the 3rd argument to $callback

1        $mime->set('text/plain', 'txt');

1        $mime->set('text/html', array('html','htm'));

1        $mime->set('text/html', 'html htm');

1        $mime->set(array(
2             'application/pdf'        => 'oda',
3             'application/postscript' => array('ai','eps')
4             ));