| 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.
Ces fonctions sont disponibles dans le module PHP
standard, qui est toujours accessible.
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.
Le comportement de ces fonctions est
affecté par la configuration dans le fichier php.ini.
Tableau 1. Options de configuration
| Nom | Par défaut | Modifiable | Historique |
|---|
| mime_magic.debug | "0" | PHP_INI_SYSTEM | Disponible depuis PHP 5.0.0. |
| mime_magic.magicfile | "/path/to/php/magic.mime" | PHP_INI_SYSTEM | Disponible depuis PHP 4.3.0. |
Pour plus de détails sur les constantes PHP_INI_*,
reportez-vous Ã
Annexe G.
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.
Cette extension ne définit aucune ressource.
Cette extension ne définit aucune constante.