Ce module est une interface vers la bibliothèque iconv.
L'extension iconv convertit des fichiers entre divers jeux de caractères.
Les jeux supportés dépendent de l'implémentation de iconv()
sur votre système. Notez que cette fonction ne fonctionne pas toujours bien
sur tous les systèmes. Dans ce cas, ce serait une bonne idée d'installer la
bibliothèque GNU libiconv.
Depuis PHP 5.0.0, cette extension dispose de beaucoup de fonctions utiles
qui peuvent vous aider à écrire des scripts multilangues.
Regardez les sections suivantes pour voir des nouvelles fonctionnalités.
Vous n'avez besoin de rien de spécial si votre système est conforme
au standard POSIX car la bibliothèque standard C fournie iconv.
Dans le cas contraire, vous devez installer la bibliothèque
libiconv sur votre système.
Pour pouvoir l'utiliser, vous devez compiler PHP avec l'option
--with-iconv[=DIR].
Note aux utilisateurs Win32Â :
Afin d'activer ce module dans l'environnement Windows®, vous
devez copier la bibliothèque iconv.dll
ou iconv-1.3.dll (pour les versions antérieures à 4.2.1)
qui est fournie avec le package PHP/Win32 dans un dossier spécifié
par la variable d'environnement PATH ou dans
un des dossiers systèmes de votre installation de Windows®.
Ce module fait parti de PHP depuis PHP 4, donc les bibliothèques
iconv.dll et php_iconv.dll
ne sont plus nécessaires.
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 |
|---|
| iconv.input_encoding | "ISO-8859-1" | PHP_INI_ALL | Disponible depuis PHP 4.0.5. |
| iconv.output_encoding | "ISO-8859-1" | PHP_INI_ALL | Disponible depuis PHP 4.0.5. |
| iconv.internal_encoding | "ISO-8859-1" | PHP_INI_ALL | Disponible depuis PHP 4.0.5. |
Pour plus de détails sur les constantes PHP_INI_*,
reportez-vous Ã
Annexe G.
| Avertissement |
Quelques systèmes (comme IBM AIX) utilisent "ISO8859-1" au lieu de "ISO-8859-1",
cette valeur doit donc être utilisée dans les options de configuration ainsi que dans
les paramètres des fonctions.
|
Note :
L'option de configuration iconv.input_encoding
n'est actuellement pas utilisée.
Cette extension ne définit aucune ressource.
Depuis PHP 4.3.0, il est possible d'identifier durant l'exécution,
la version de la bibliothèque iconv que vous utilisez.
Tableau 2. Constantes iconv
| Constante | Type | Description |
|---|
| ICONV_IMPL | string | Le nom de la bibliothèque |
| ICONV_VERSION | string | La version de la bibliothèque |
Note :
La programmation de scripts dépendant de versions spécifiques,
avec ces constantes, est fortement déconseillée.
Depuis PHP 5.0.0, les contantes suivantes sont également disponibles :
Tableau 3. Constantes iconv disponibles depuis PHP 5.0.0
