XL. Iconv

Introduction

Ce module est une interface vers la librairie 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, vous devez installer la librairie tout de même.

Pré-requis

Pour cela, vous devez avoir la fonction iconv() dans votre librairie standard C, ou bien la librairie libiconv installée sur votre système. La librairie libiconv est disponible à http://www.gnu.org/software/libiconv/.

Installation

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 librairies 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 or C:\WINDOWS\SYSTEM32). Depuis PHP 4.2.1, le nom de cette librairie a été changée en iconv.dll.

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éfautModifiable
iconv.input_encodingICONV_INPUT_ENCODINGPHP_INI_ALL
iconv.output_encodingICONV_OUTPUT_ENCODINGPHP_INI_ALL
iconv.internal_encodingICONV_INTERNAL_ENCODINGPHP_INI_ALL
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à ini_set().

Types de ressources

Cette extension ne définit aucune ressource.

Constantes prédefinies

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

ConstanteTypeDescription
ICONV_IMPLstringLe nom de la bibliothèque
ICONV_VERSIONstringLa version de la bibliothèque

Note : La programmation de scripts dépendant de versions spécifiques, avec ces constantes est fortement déconseillée.

Voir aussi

Voir aussi les fonctions GNU Recode.

Table des matières
iconv_get_encoding --  Lit le jeu de caractères courant
iconv_mime_decode_headers --  Decodes multiple MIME header fields at once
iconv_mime_decode --  Décode un champ d'entête MIME
iconv_mime_encode --  Construit un entête MIME avec les champs field_name et field_value
iconv_set_encoding --  Modifie le jeu courant de caractères courant
iconv_strlen --  Retourne le nombre de caractères d'une chaîne
iconv_strpos --  Trouve la position de la première occurence de needle dans haystack
iconv_strrpos --  Trouve la position de la dernière occurence d'un élément dans une chaîne, à partir d'un offset
iconv_substr --  Retourne une partie de chaîne iconv
iconv -- Convertit une chaîne dans un jeu de caractères
ob_iconv_handler --  Gestionnaire de sortie pour maitriser le jeu de caractères de sortie