Manuel PHP
Précédent |  | Suivant

# LXXXIV. 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

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.

# Types de ressources

Cette extension ne définit aucune ressource.

# Constantes pré-définies

Cette extension ne définit aucune constante.

Précédent | Sommaire | Suivant
mhash | Niveau supérieur | mime_content_type