Iconv
Introduction
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.
Pré-requis
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.
Installation
Pour pouvoir l'utiliser, vous devez compiler PHP avec l'option --with-iconv[=DIR].
Note: 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.
Configuration à l'exécution
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
| 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. |
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.
Types de ressources
Cette extension ne définit aucune ressource.
Constantes pré-définies
Depuis PHP 4.3.0, il est possible d'identifier durant l'exécution, la version de la bibliothèque iconv que vous utilisez.
| 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 :
| Constante | Type | Description |
|---|---|---|
| ICONV_MIME_DECODE_STRICT | entier | Un masque utilisé par iconv_mime_decode() |
| ICONV_MIME_DECODE_CONTINUE_ON_ERROR | entier | Un masque utilisé pour iconv_mime_decode() |
Voir aussi
Voir aussi les fonctions GNU Recode.
Table of Contents
- 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
- 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