L’encodage UTF-8 est devenu la norme incontournable pour la représentation des caractères dans les applications web modernes. Sa capacité à gérer une large variété de caractères en fait un choix privilégié.
Cet article détaille la configuration de l’encodage UTF-8 sur différents serveurs d’applications populaires, notamment IBM WAS, Oracle WebLogic, Tomcat, TC Server et JBoss, offrant ainsi un guide pratique pour les administrateurs système.
Configuration sur le serveur d’applications WebSphere
- Accéder à la console d’administration de WebSphere.
- Développer le menu « Serveurs » puis « Serveurs d’applications ».
- Sélectionner le serveur d’applications (JVM) sur lequel vous souhaitez activer UTF-8.
- Dans l’infrastructure du serveur, développer « Java et gestion des processus ».
- Cliquer sur « Définition du processus ».
- Choisir l’option « Machine virtuelle Java ».
- Ajouter la ligne suivante dans le champ « Arguments Java génériques » :
-Dclient.encoding.override=UTF-8
- Valider en cliquant sur « OK » puis synchroniser le nœud si nécessaire.
- Redémarrer le serveur d’applications (JVM) pour que les changements soient effectifs.
Paramétrage sur le serveur Oracle WebLogic
- Se rendre dans le répertoire du domaine WebLogic.
- Ouvrir le dossier « bin ».
- Ajouter la ligne suivante dans le fichier `setDomainEnv.sh`, à l’intérieur de la variable `JAVA_OPTS` :
-Dfile.encoding=utf8
- Redémarrer le serveur WebLogic afin que la nouvelle configuration soit prise en compte.
Mise en place sur Tomcat
- Accéder au répertoire d’installation de Tomcat.
- Ouvrir le dossier « conf ».
- Dans le fichier `server.xml`, ajouter l’attribut suivant pour chaque port de connecteur que vous utilisez :
URIEncoding="UTF-8"
- Retourner au répertoire d’installation de Tomcat.
- Ouvrir le dossier « bin ».
- Dans le fichier `catalina.sh`, ajouter ces paramètres dans la variable `JAVA_OPTS` :
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8
Exemple :
JAVA_OPTS="-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8"
- Redémarrer le serveur Tomcat pour que les modifications soient prises en compte.
Configuration du serveur TC
- Accéder au répertoire de l’instance du serveur TC.
- Ouvrir le dossier « conf ».
- Dans le fichier `server.xml`, ajouter l’attribut suivant pour chaque port de connecteur :
URIEncoding="UTF-8"
- Retourner au répertoire de l’instance du serveur TC.
- Ouvrir le dossier « bin ».
- Dans le fichier `setenv.sh`, ajouter les paramètres suivants dans la variable `CATALINA_OPTS` :
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8
Exemple :
CATALINA_OPTS="-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8"
- Redémarrer le serveur TC pour valider la configuration.
Configuration sur le serveur d’applications JBoss
- Se rendre dans le répertoire d’installation de JBoss.
- Ouvrir le dossier « bin ».
- Ajouter le paramètre suivant dans le fichier `standalone.conf`, au niveau de la variable `JAVA_OPTS` :
-Dfile.encoding=UTF-8
- Redémarrer le serveur JBoss pour appliquer les modifications.
Outils de vérification de l’encodage UTF-8
Pour vérifier que votre application web prend correctement en charge l’encodage UTF-8, vous pouvez utiliser les outils de validation en ligne suivants :
http://coderstoolbox.net/string/
Nous espérons que ces instructions détaillées vous seront utiles pour configurer l’encodage UTF-8 sur différents serveurs d’applications. La bonne gestion de l’encodage est essentielle pour le bon fonctionnement de vos applications web.
Si vous souhaitez approfondir vos connaissances en administration d’Oracle WebLogic, nous vous invitons à consulter ce cours de Chris Parent.
Cet article vous a été utile ? N’hésitez pas à le partager !