XLI. 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, ce serait une bonne idée d'installer la librairie 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.

Pré-requis

Vous n'avez besoin de rien de spécial si votre système est conforme au standard POSIX car la librairie standart C fournie iconv. Dans le cas contraire, vous devez installer la librairie libiconv sur votre système.

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 ou 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

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

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

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

Voir aussi les fonctions GNU Recode.

Table des matières
iconv_get_encoding -- Lit le jeu de caractères courant
iconv_mime_decode_headers -- Décode des en-têtes MIME multiples
iconv_mime_decode -- Décode un champ d'en-tête MIME
iconv_mime_encode -- Construit un en-tête MIME avec les champs field_name et field_value
iconv_set_encoding -- Modifie le jeu courant de caractères d'encodage
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 maîtriser le jeu de caractères de sortie