LXXVI. Fonctions Mimetype

Introduction

Avertissement

Cette extension est à présent déconseillée étant donné que l'extension PECL fileinfo fournit les mêmes fonctionnalités (et même plus) de façon plus propre.

Ces fonctions essaient de définir le type de contenu et l'encodage d'un fichier en recherchant certaines séquences magiques, à certaines positions dans le fichier. Même si ce n'est pas une approche imparable, les heuristiques réalisent un bon travail.

Cette extension est dérivée du module Apache mod_mime_magic, qui est lui-même basé sur la commande file, entretenue par Ian F. Darwin. Voyez le code source pour plus de détails sur les heuristiques et les informations de copyright.

Pré-requis

Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.

Installation

Vous devez compiler PHP avec l'option --enable-mime-magic pour obtenir le support des fonctions mime-type. L'extension nécessite une copie simplifiée de magic qui est distribuée avec le serveur httpd Apache.

Note : L'option de configuration a été changée de --enable-mime-magic en --with-mime-magic depuis PHP 4.3.2

Note : Cette extension n'est pas capable d'utiliser le fichier magic complet, qui est généralement livré avec les distributions Linux, et il est supposé fonctionner avec les plus récentes versions de la commande file.

Note aux utilisateurs Windows : Afin de pouvoir utiliser ce module en environnement Windows, vous devez activer le chemin jusqu'au fichier magic.mime de votre php.ini.

Exemple 1. Configuration Windows de magic.mime

mime_magic.magicfile ="$PHP_INSTALL_DIR\magic.mime"

N'oubliez pas de remplacer la valeur de $PHP_INSTALL_DIR par votre chemin jusqu'à l'exécutable PHP, dans l'exemple ci-desssus. Par exemple, c:\php.

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Tableau 1. Options de configuration

NomPar défautModifiableHistorique
mime_magic.debug"0"PHP_INI_SYSTEMDisponible depuis PHP 5.0.0.
mime_magic.magicfile"/path/to/php/magic.mime"PHP_INI_SYSTEMDisponible depuis PHP 4.3.0.
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe H.

Voici un éclaircissement sur l'utilisation des directives de configuration.

mime_magic.debug ???

Active / Désactive le débogage.

mime_magic.magicfile chaîne de caractères

Le chemin vers le fichier magic.mime.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

Cette extension ne définit aucune constante.

Table des matières
mime_content_type -- Détecte le type MIME d'un fichier

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:20