par
AB » 11 déc. 2008, 05:54
- Apache, php et mysql travaillent encore aujourd'hui par défaut avec la norme ISO-8859-1. L'inconvénient de cette norme est qu'elle utilise un encodage des caractères ou symboles sur un octet soit seulement 256 possibilités.
C'est pour dépasser cette limite et pouvoir faire afficher par exemple des caractères français et chinoix sur une même page qu'a été développé l'unicode et plus particulièrement l'UTF-8 très utilisé pour les applications Unix et Internet.
L'UTF-8 peut encoder sur 1 à 4 octects et permet l'affichage de quasiment tous les caractères et symboles internationnaux. La future version PHP6 adoptera cette norme par défaut.
Cette norme possède néanmoins les inconvénients de ses avantages : pour gagner de la place en mémoire certains caractères seront encodés sur un octet alors que d'autres le seront sur deux (caractères accentués français par exemple) ou plus. Or de nombreuses fonctions php de recherche sur les chaines de caractères utilisent le nombre d'octets trouvés. Par exemple la fonction strlen('aé') retournera donc 3 sur une page codée en UTF-8 alors qu'elle est censée retourner la longueur de la chaine 'aé' soit une valeur attendue de 2.
Il est donc important d'être homogène tout au long de la création de votre projet, de la configuration de vos outils de travail en UTF-8, à l'utilisation de fonctions adéquates au traitement des chaines multi-octets.
Configurer votre outil de travail
- Il est indispensable d'enregistrer vos fichiers en choisissant l'encodage UTF-8, par exemple :
- Eclipse : Window > préferences > Géneral > WorkSpace > boite "Text file encoding"
- Notepad++ : Paramétrage > Nouveau document. Pour modifier le document courant : Format > "Encoder en UTF8"
- Zend Studio : Tools > Desktop > Apparence
- Dreamweaver : Edition > Préférences > Nouveau document > Codage par défaut
- Bloc notes window : Enregistrer sous > codage
Dans tous les cas si cela vous est proposé, ne pas inclure une signature unicode BOM
Configuration des entêtes
PHP
MySql
FAQ
- Problèmes d'affichage
Si la page affiche des caractères de ce type : "é", "î", "Ã", ...
=> Les données ont été enregistrées au format UTF-8, et le navigateur les affiche en pensant avoir affaire à de l'ISO.
Si la page affiche des caractères de ce type : "�"
=> Les données ont été enregistrées au format ISO, et le navigateur les affiche en pensant avoir affaire à de l'UTF-8.
Si les données sont codées en dur dans la page, voir l'encodage de l'éditeur de texte, l'header apache et la balise meta "charset".
Si les données proviennent de la base, vérifier le format de stockage et les méthodes de lecture et d'insertion (SET NAMES et charset).
Si les données proviennent de l'extérieur (web services, rss, ...), penser à convertir les chaînes de caractère (utf8_encode-decode et fonctions du module iconv).
Utilisation de fonctions pouvant poser problème avec les chaines multi octet
Erreurs courantes
- strtr() => utilisez str_replace()
- htmlentities() => spécifiez le charset utf-8 ou mieux utilisez htmlspecialchars()
- strpos(), strlen(), substr() etc. => utilisez les fonctions adaptées au traitement des chaines UTF-8
Consultez ce lien http://www.phpwact.org/php/i18n/utf-8
Migration d'un site d'ISO-8859-1 vers UTF-8
En plus des conseils ci-dessus ce lien peut vous être utile
Ce tuto a été réalisé en s'inspirant de
http://electron-libre.fassnet.net/utf8.php et
http://www.phpfrance.com/forums/voir_re ... php#272340[list]Apache, php et mysql travaillent encore aujourd'hui par défaut avec la norme ISO-8859-1. L'inconvénient de cette norme est qu'elle utilise un encodage des caractères ou symboles sur un octet soit seulement 256 possibilités.
C'est pour dépasser cette limite et pouvoir faire afficher par exemple des caractères français et chinoix sur une même page qu'a été développé [url=http://fr.wikipedia.org/wiki/Unicode]l'unicode[/url] et plus particulièrement l'UTF-8 très utilisé pour les applications Unix et Internet.
L'UTF-8 peut encoder sur 1 à 4 octects et permet l'affichage de quasiment tous les caractères et symboles internationnaux. La future version PHP6 adoptera cette norme par défaut.
Cette norme possède néanmoins les inconvénients de ses avantages : pour gagner de la place en mémoire certains caractères seront encodés sur un octet alors que d'autres le seront sur deux (caractères accentués français par exemple) ou plus. Or de nombreuses fonctions php de recherche sur les chaines de caractères utilisent le nombre d'octets trouvés. Par exemple la fonction strlen('aé') retournera donc 3 sur une page codée en UTF-8 alors qu'elle est censée retourner la longueur de la chaine 'aé' soit une valeur attendue de 2.
Il est donc important d'être homogène tout au long de la création de votre projet, de la configuration de vos outils de travail en UTF-8, à l'utilisation de fonctions adéquates au traitement des chaines multi-octets. [/list]
[b][size=150]Configurer votre outil de travail[/size][/b]
[list]Il est indispensable d'enregistrer vos fichiers en choisissant l'encodage UTF-8, par exemple :
- Eclipse : Window > préferences > Géneral > WorkSpace > boite "Text file encoding"
- Notepad++ : Paramétrage > Nouveau document. Pour modifier le document courant : Format > "Encoder en UTF8"
- Zend Studio : Tools > Desktop > Apparence
- Dreamweaver : Edition > Préférences > Nouveau document > Codage par défaut
- Bloc notes window : Enregistrer sous > codage
Dans tous les cas si cela vous est proposé, ne pas inclure une signature unicode BOM[/list]
[b][size=150]Configuration des entêtes[/size][/b]
[list][b]HTML[/b]
Il vous suffit d'indiquer le charset dans une balise meta à la suite de la balise head
[code]<head>
<meta http-equiv="Content-type" content="text/html; charset=UTF-8"/>
...
</head>[/code]
Cette ligne doit logiquement être la première suivant la balise <head> puisqu'elle indique au navigateur l'encodage utilisé.
Attention, l'entête envoyée par le serveur sera prioritaire sur cette déclaration html
[b]APACHE[/b]
Comme mentionné en préambule, le serveur apache envoie (généralement pour l'instant) des entêtes à la norme ISO-8859-1.
- Si vous avez accès à la configuration du serveur > httpd.conf, ajoutez l'une ou l'autre des lignes
[code]AddDefaultCharset UTF-8
#ou
AddDefaultCharset Off[/code]
Avec la deuxième solution le serveur se renseigne sur l'entête http et sera donc en cohérence avec le charset indiqué dans la page html.
- Sans accès à la configuration du serveur vous pouvez mettre l'une ou l'autre des lignes ci-dessus dans un fichier .htacces
- Sinon indiquez au début de vos pages php
[php]header('Content-Type: text/html; charset=UTF-8');[/php]
Cette dernière solution permet un meilleur portage de vos scripts.[/list]
[b][size=150]PHP[/size][/b]
[list][b]Configuration php.ini[/b]
Le module "mbstring" s'occupe de la manipulation des chaînes tandis que le module "iconv" permet de convertir différents types d'encodages.
Les conversions entre ISO et UTF-8 peuvent se réaliser à l'aide des fonctions utf8_encode() et utf8_decode().
Dans la plupart des cas vous n'aurez pas à intervenir sur la configuration du php.ini.
[b]Utilisation des fonctions de traitement des chaines multi octets[/b]
Pour reprendre l'exemple initial, mb_strlen() sera utilisée à la place de strlen().
Liste des fonctions adaptées au [url=http://fr2.php.net/manual/fr/ref.mbstring.php]traitement des chaines UTF-8[/url]
PHP travaille pour l'instant en ISO, il faudra donc spécifier l'encodage utilisé pour les fonctions qui le demande ou modifier l'encodage initial.
Typiquement :
[php]echo mb_internal_encoding(); //affiche ISO-8859-1
echo mb_strlen('aé');// affiche 3
echo mb_strlen('aé',"utf-8");// affiche 2
mb_internal_encoding("UTF-8");// indique d'utiliser l'encodage UTF-8
echo mb_strlen('aé');// affiche 2[/php][/list]
[b][size=150]MySql[/size][/b]
[list]Pour MySql comme pour toute autre base de donnée il est préférable de créer votre base en spécifiant l'encodage utf8_general_ci.
Cette possibilité est cependant rarement disponible sur les serveurs mutualisés. Pour contourner ce problème et une meilleure portabilité de votre code, vous pouvez indiquer l'encodage à utiliser en envoyant la requête "SET NAMES UTF8" juste après la connexion à votre base.
[php]mysql_select_db($database, $connection);
mysql_query("SET NAMES 'utf8'");[/php]
Vos tables doivent également être créées en utilisant l'Interclassement utf8_general_ci via phpMyAdmin ou dans une fenêtre sql :
[code]CREATE TABLE IF NOT EXISTS `membres` (
`pseudo` varchar(100) NOT NULL,
`pass` varchar(100) character set utf8 collate utf8_bin NOT NULL,
PRIMARY KEY (`pseudo`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;[/code]
Dans cet exemple le champ "pass" est formaté avec "collate utf8_bin" pour être sensible à la casse.[/list]
[b][size=150]FAQ[/size][/b]
[list][b]Problèmes d'affichage[/b]
Si la page affiche des caractères de ce type : "é", "î", "Ã", ...
=> Les données ont été enregistrées au format UTF-8, et le navigateur les affiche en pensant avoir affaire à de l'ISO.
Si la page affiche des caractères de ce type : "�"
=> Les données ont été enregistrées au format ISO, et le navigateur les affiche en pensant avoir affaire à de l'UTF-8.
Si les données sont codées en dur dans la page, voir l'encodage de l'éditeur de texte, l'header apache et la balise meta "charset".
Si les données proviennent de la base, vérifier le format de stockage et les méthodes de lecture et d'insertion (SET NAMES et charset).
Si les données proviennent de l'extérieur (web services, rss, ...), penser à convertir les chaînes de caractère (utf8_encode-decode et fonctions du module iconv).
[b]Utilisation de fonctions pouvant poser problème avec les chaines multi octet[/b]
Erreurs courantes
- strtr() => utilisez str_replace()
- htmlentities() => spécifiez le charset utf-8 ou mieux utilisez htmlspecialchars()
- strpos(), strlen(), substr() etc. => utilisez les fonctions [url=http://fr2.php.net/manual/fr/ref.mbstring.php]adaptées au traitement des chaines UTF-8[/url]
[b]Consultez ce lien[/b] http://www.phpwact.org/php/i18n/utf-8
[b]Migration d'un site d'ISO-8859-1 vers UTF-8[/b]
En plus des conseils ci-dessus ce [url=http://www.phpfrance.com/forums/voir_sujet-244096.php]lien peut vous être utile[/url][/list]
Ce tuto a été réalisé en s'inspirant de http://electron-libre.fassnet.net/utf8.php et http://www.phpfrance.com/forums/voir_reponse-272340.php#272340
