Même si la plupart des langues peuvent être représentées grâce à un jeu de 128 caractères, il y a d'autres langues qui requièrent des jeux de caractères bien plus grands. Des méthodes de caractères multi-octets ont été développées pour résoudre ce type de problème.
Lorsque vous manipulez des chaînes de caractères multi-octets, pour couper, rechercher ou nettoyer une chaîne, vous devez utiliser deux octets consécutifs, qui représentent un seul caractère. Si vous n'y prenez pas garde, vous allez obtenir une chaîne corrompue et invalide, avec une représentation totalement incompréhensible.
mbstring fournit les fonctions spécifiques de manipulations de chaînes qui vous permet de travailler avec les encodages multi-octets en PHP. En plus de cela, mbstring gère la traduction entre les jeux de caractères disponibles. mbstring est également connu pour gérer l'Unicode, comme UTF-8 et UCS-2 ainsi que de nombreux autres jeux mono-octets.
Les jeux de caractères suivants sont bien supportés par PHP.
Jeux de caractères mono-octets :
Jeux de caractères multi-octets :
Les jeux de caractères suivants risquent de ne pas fonctionner en PHP.
Example#1 Jeux de caractères qui risquent de ne pas fonctionner en PHP
JIS, SJIS, ISO-2022-JP, BIG-5
Même si aucun script PHP écrit avec ces jeux de caractères ne fonctionne, notamment si des chaînes encodées sont utilisées comme identifiants, ou valeurs littérales dans le script, vous pouvez éviter d'utiliser ces jeux en activant le filtre transparent mbstring pour les données d'entrées HTTP.
Note: Il est déconseillé d'utiliser les jeux SJIS, BIG5, CP936, CP949 et GB18030 pour l'encodage interne, à moins que vous ne soyez très familiers avec l'analyseur, le scanneur et le jeu de caractère lui-même.
Note: Si vous vous connectez à une base de données avec PHP, il est recommandé d'utiliser le même jeu de caractères pour la base de données et pour le jeu interne pour améliorer le confort d'utilisation mais aussi les performances.
Si vous utilisez PostgreSQL, le jeu de caractères utilisé dans la base de données et celui de PHP peuvent différer car cette base supporte la traduction automatique de jeu de caractères.
mbstring est un module PHP. Vous devez activer le module avec le script de configuration configure. Reportez-vous à la section installation pour plus de détails.
Les options de configurations suivantes sont liées au module mbstring.
--enable-mbstring : Active les fonctions mbstring. Cette option est nécessaire pour utiliser les fonctions mbstring.
libmbfl est nécessaire pour mbstring. libmbfl est inclus avec mbstring. Si libmbfl est déjà installé sur le système, --with-libmbfl[=DIR] peut être spécifié pour utiliser la bibliothèque istallée.
À partir de PHP 4.3.0, l'extension mbstring fournit le support pour le chinois simplifié, le chinois traditionnel, le coréen et le russe en plus du japonais.
Pour PHP 4.3.3 ou inférieur, pour activer cette fonctionnalité, vous devez fournir une des options suivantes dans le paramètres LANG de --with-mbstring=LANG : --with-mbstring=cn pour le support du chinois simplifié, --with-mbstring=tw pour le support du chinois traditionnel, --with-mbstring=kr pour le support du coréen, --with-mbstring=ru pour le support du russe et --enable-mbstring=ja pour le support du japonais (par défaut). Pour activer le support de tous ces encodages, utilisez --enable-mbstring=all.
Note: Depuis PHP 4.3.4, tous les encodages supportés par libmbfl sont activables avec l'option --enable-mbstring.
--enable-mbstr-enc-trans : Active la conversion automatique des données par HTTP, avec le moteur de conversion de mbstring. Si cette option est activée, les données venant du web via HTTP seront converties dans le jeu de caractères mbstring.internal_encoding, automatiquement.
Note: Depuis PHP 4.3.0, l'option --enable-mbstr-enc-trans sera éliminée, et remplacée par mbstring.encoding_translation. La conversion de jeu de caractères d'entrée HTTP sera activée lorsque cette option sera à On (par défaut, cette option vautOff).
--disable-mbregex : Désactive les fonctions d'expressions rationnelles, compatibles avec les caractères multi-octets.
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
Nom | Par défaut | Modifiable | Historique |
---|---|---|---|
mbstring.language | "neutral" | PHP_INI_PERDIR | Disponible depuis PHP 4.3.0 |
mbstring.detect_order | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.6 |
mbstring.http_input | "pass" | PHP_INI_ALL | Disponible depuis PHP 4.0.6 |
mbstring.http_output | "pass" | PHP_INI_ALL | Disponible depuis PHP 4.0.6 |
mbstring.internal_encoding | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.6 |
mbstring.script_encoding | NULL | PHP_INI_ALL | Disponible depuis PHP 4.3.0 |
mbstring.substitute_character | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.6 |
mbstring.func_overload | "0" | PHP_INI_PERDIR | PHP_INI_SYSTEM en PHP <= 4.2.3. Disponible depuis PHP 4.2.0 |
mbstring.encoding_translation | "0" | PHP_INI_PERDIR | Disponible depuis PHP 4.3.0 |
mbstring.strict_detection | "0" | PHP_INI_ALL | Disponible depuis PHP 5.1.2. |
Voici un éclaircissement sur l'utilisation des directives de configuration.
Définit le langage utilisé par mbstring. Notez que cette option définit mbstring.internal_encoding mbstring.internal_encoding doit être placé après mbstring.language dans le fichier php.ini
Active la détection et la traduction des données d'entrées HTTP vers le codage interne mbstring.
Définit l'encodage interne par défaut.
Définit l'encodage de réception HTTP par défaut.
Définit l'encodage d'affichage HTTP par défaut.
Définit l'ordre de détection des encodages par défaut. Voir aussi mb_detect_order().
Définit l'encodage de substitution par défaut : il est utilisé pour les caractères invalides.
Remplace les fonctions de traitement des chaînes par les fonctions mbstring. Voir les fonctions de remplacement pour plus d'informations.
Active la détection stricte de l'encodage.
En accord avec » HTML 4.01 specification, les navigateurs sont supposés utiliser le même jeu de caractères lorsqu'ils soumettent un formulaire. Mais, tous les navigateurs ne le font pas. Reportez-vous à la fonction mb_http_input() pour détecter les jeux de caractères utilisés par les navigateurs.
En général, les navigateurs sont suffisamment intelligents pour détecter les jeux de caractères dans le HTML. Si charset est activé dans les en-têtes, cela donnera de meilleurs résultats. Changez la valeur de default_charset avec la valeur appropriée dans le fichier ini.
Example#2 Configuration de php.ini pour mbstring
; Langage par défaut mbstring.language = Neutral; (UTF-8) (par défaut) mbstring.language = English; Anglais mbstring.language = Japanese; Japonais ;; Jeu de caractère interne ;; Note : assurez-vous que ce jeu fonctionne avec PHP mbstring.internal_encoding = UTF-8 ;; Activation de la conversion automatique des entrées HTTP mbstring.encoding_translation = On ;; Jeu de caractères par défaut pour les données d'entrée HTTP ;; Note : le script ne peux pas changer cette configuration mbstring.http_input = pass ; Aucune conversion. mbstring.http_input = auto ; Utilise auto ; "auto" est remplacé par "ASCII,JIS,UTF-8,EUC-JP,SJIS" mbstring.http_input = SJIS ; Utilise SJIS mbstring.http_input = UTF-8,SJIS,EUC-JP ; Spécifie l'ordre ;;Jeu de caractères par défaut pour les données de sortie HTTP mbstring.http_output = pass ; Aucune conversion mbstring.http_output = UTF-8 ; Utilise UTF-8 ;; Ordre de détection des jeux de caractères mbstring.detect_order = auto ; Utilise la détection automatique mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Spécifie l'ordre ;; Déterminer le jeu de caractères de substitution par défaut mbstring.substitute_character = 12307 ; Spécifie une valeur Unicode mbstring.substitute_character = none ; Ne pas afficher de caractères mbstring.substitute_character = long ; Exemple complet : U+3000,JIS+7E7E
Example#3 Configuration de php.ini pour les utilisateurs de EUC-JP
;; Désactive la bufferisation de sortie output_buffering = Off ;; Choisit le jeu de caractères default_charset = EUC-JP ;; Le langage par défaut est le japonais mbstring.language = Japanese ;; Activation de la traduction automatique des données d'entrée HTTP mbstring.encoding_translation = On ;; Activation de la conversion automatique mbstring.http_input = auto ;; Convertit les sorties en EUC-JP mbstring.http_output = EUC-JP ;; Utilise le jeu de caractères interne EUC-JP mbstring.internal_encoding = EUC-JP ;; Ne pas afficher les caractères invalides mbstring.substitute_character = none
Example#4 Configuration de php.ini pour les utilisateurs de SJIS
;; Active la bufferisation de sortie output_buffering = On ;; Utilise le gestionnaire mb_output_handler pour la conversion de sortie output_handler = mb_output_handler ;; Choisit le jeu de caractères default_charset = Shift_JIS ;; Le langage par défaut est le japonais mbstring.language = Japanese ;; Activation de la traduction automatique des données d'entrée HTTP mbstring.http_input = auto ;; Convertit en SJIS mbstring.http_output = SJIS ;;Utilise le jeu de caractères interne EUC-JP mbstring.internal_encoding = EUC-JP ;; Ne pas afficher les caractères invalides mbstring.substitute_character = none
Cette extension ne définit aucune ressource.
Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.
La conversion automatique des entrées/sorties HTTP peut aussi convertir des données binaires. Les utilisateurs doivent contrôler les conversions, si des données binaires doivent être utilisées via HTTP.
Note: Depuis la version 4.3.2 de PHP, il y a une limitation dans l'utilisation des fonctionnalités mbstring : l'encodage ne sera pas effectué dans les données transmises en méthode POST si l'attribut enctype de la balise form vaut multipart/form-data. Donc, vous devrez convertir les données entrantes vous-même dans ce cas, si nécessaire.
Depuis la version 4.3.3 de PHP, si l'attribut enctype de la balise form vaut multipart/form-data et que la directive du php.ini est positionnée à On, les variables et les noms de fichiers téléchargés en méthode POST seront convertis avec l'encodage interne. Sinon, la conversion ne sera pas faite.
Il n'y a pas de moyens de contrôler la conversion des caractères HTTP en entrée, depuis un script PHP. Pour désactiver cette conversion, il faut le faire dès le fichier php.ini.
Example#5 Désactive la conversion HTTP dans le php.ini
;; Désactive la conversion HTTP
mbstring.http_input = pass
;; Désactive la conversion HTTP (PHP 4.3.0 ou plus récent)
mbstring.encoding_translation = Off
Lorsque vous utilisez PHP comme module Apache, il est possible d'annuler la configuration du php.ini pour chaque Virtual Host dans le fichier httpd.conf ou par dossier avec le fichier .htaccess. Reportez-vous à la section de configuration ainsi qu'au manuel Apache.
Il y a plusieurs moyens d'activer la conversion en sortie de script PHP. L'un d'entre eux utilise php.ini, un autre utilise ob_start() avec la fonction mb_output_handler() comme fonction de call-back.
Note: Pour les utilisateurs PHP3-i18n, le système de conversion de mbstring diffère de celui de PHP3-i18n. Le jeu de caractère est converti avec un buffer de sortie.
Example#6 Exemple de configuration de mbstring dans php.ini
;; Active la conversion de sortie pour toutes les pages PHP
;; Active la bufferisation de sortie
output_buffering = On
;; Choisi mb_output_handler pour effectuer la conversion de sortie
output_handler = mb_output_handler
Example#7 Exemple de script avec mbstring
<?php
// Active la conversion de caractère uniquement pour cette page
// Choisi le jeu de caractères SJIS
mb_http_output('SJIS');
// Commence la bufferisation et spécifie "mb_output_handler"
// comme fonction de callback
ob_start('mb_output_handler');
?>
Actuellement, les jeux de caractères suivants sont supportés par mbstring. L'encodage de caractère peut être spécifié par les paramètres encoding dans les fonctions mbstring.
Les jeux de caractères suivants sont supportés par mbstring :
Toutes les entrées du php.ini qui acceptent un nom d'encodage peuvent également utiliser les valeurs "auto" et "pass". Les fonctions mbstring, qui acceptent des noms de jeux de caractères, peuvent également utiliser la valeur "auto".
Si "pass" est utilisée, aucune conversion n'est effectuée.
Si "auto" est défini, la liste sera étendue à la liste des encodages définis par NLS. Par exemple, si NLS vaut Japanese, les valeurs seront "ASCII,JIS,UTF-8,EUC-JP,SJIS".
Voir aussi mb_detect_order().
Vous pourriez trouver difficile de faire fonctionner une application PHP existante dans un environnement multi-octets. Ceci est dû au fait que la plupart des applications PHP sont écrites avec des fonctions de chaînes de caractères standards comme la fonction substr(), qui est connue pour ne pas gérer proprement les chaînes multi-octets.
Mbstring supporte aussi la surcharge de fonctions, pour permettre le support des chaînes multi-octets sans modifier les scripts PHP. En utilisant ce système de surcharge de fonctions, certaines fonctions PHP seront remplacées par leur équivalent de mbstring. Par exemple mb_substr() remplacera substr(). Ce système de remplacement transparent, permet un portage simple et efficace des applications.
Pour utiliser la surcharge de fonctions, définissez mbstring.func_overload, dans le php.ini, à une valeur positive qui représente une combinaison de masques d'octets spécifiant les catégories de fonctions à surcharger. Il doit être définit à 1 pour surcharger la fonction mail(), 2 pour les fonction de chaînes, 4 pour les fonctions d'expression rationnelles. Par exemple, avec la valeur 7, toutes les fonctions précédentes seront surchargées. Voici la liste complète des fonctions surchargées, avec leur fonction de remplacement.
Valeur de mbstring.func_overload | Fonction originale | Fonction de remplacement |
---|---|---|
1 | mail() | mb_send_mail() |
2 | strlen() | mb_strlen() |
2 | strpos() | mb_strpos() |
2 | strrpos() | mb_strrpos() |
2 | substr() | mb_substr() |
2 | strtolower() | mb_strtolower() |
2 | strtoupper() | mb_strtoupper() |
2 | substr_count() | mb_substr_count() |
4 | ereg() | mb_ereg() |
4 | eregi() | mb_eregi() |
4 | ereg_replace() | mb_ereg_replace() |
4 | eregi_replace() | mb_eregi_replace() |
4 | split() | mb_split() |
Note: Il n'est pas recommandé d'utiliser les options des fonctions d'overloading dans un contexte de per-directory, car il n'est pas confirmé encore qu'elles sont suffisamment stables dans un environnement de production et peuvent conduire à un résultat incohérent.
Les caractères japonais ne peuvent être représentés qu'avec des encodages multi-octets et les standards d'encodage multiple sont utilisés suivant la plateforme et le texte de référence. Pour facilité les choses, ces standards d'encodages diffèrent légèrement les uns des autres. Pour développer des applications Web en environnement japonais, le développeur devra garder à l'esprit ces complexités afin de s'assurer que l'encodage de caractères correct est utilisé.
Les jeux de caractères multi-octets et leurs techniques sont très complexes et ne peuvent être traités totalement dans cette documentation. Reportez-vous aux URL suivantes pour d'autres ressources complémentaires :
Unicode/UTF/UCS/etc
Japonais/coréen/Chinois