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 standart 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 les bibliothèques iconv-1.3.dll depuis le dossier DLL de PHP/Win32 dans le dossier système SYSTEM32 de votre machine (par exemple : C:\WINNT\SYSTEM32 ou C:\WINDOWS\SYSTEM32). Depuis PHP 4.2.1, le nom de cette bibliothèque a été changée en iconv.dll.
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 |
---|---|---|
iconv.input_encoding | ICONV_INPUT_ENCODING | PHP_INI_ALL |
iconv.output_encoding | ICONV_OUTPUT_ENCODING | PHP_INI_ALL |
iconv.internal_encoding | ICONV_INTERNAL_ENCODING | PHP_INI_ALL |
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
Constante | Type | Description |
---|---|---|
ICONV_MIME_DECODE_STRICT | integer | Un masque utilisé par iconv_mime_decode() |
ICONV_MIME_DECODE_CONTINUE_ON_ERROR | integer | Un masque utilisé pour iconv_mime_decode() |
Voir aussi les fonctions GNU Recode.
Précédent | Sommaire | Suivant |
hw_api->userlist | Niveau supérieur | iconv_get_encoding |