Idéalement, un jeu de caractères propre doit être défini au niveau du serveur, opération décrite dans la section » Configuration du jeu de caractères du manuel MySQL Server. Alternativement, chaque API MySQL offre une méthode pour définir le jeu de caractères lors de l'exécution.
Le jeu de caractères doit être compris et défini, sachant qu'il a un effet sur chaque action, et a des implications au niveau de la sécurité. Par exemple, le mécanisme d'échappement (i.e. mysqli_real_escape_string() pour mysqli, mysql_real_escape_string() pour mysql, et PDO::quote() pour PDO_MySQL) va utiliser cette configuration. Il est important de garder en tête que ces fonctions n'utiliseront pas le jeu de caractères défini avec une requête, aussi, l'exemple suivant n'aura aucun effet sur le jeu de caractères :
Exemple #1 Problèmes lors de la définition du jeu de caractères avec SQL
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
// N'affectera PAS $mysqli->real_escape_string();
$mysqli->query("SET NAMES utf8");
// N'affectera PAS $mysqli->real_escape_string();
$mysqli->query("SET CHARACTER SET utf8");
// Mais, ceci affectera $mysqli->real_escape_string();
$mysqli->set_charset('utf8');
// Mais, ceci NE l'affectera PAS (utf-8 par rapport à utf8) -- n'utilisez pas les tirets ici
$mysqli->set_charset('utf-8');
?>
Ci-dessous les exemples qui démontrent la façon de modifier proprement le jeu de caractères lors de l'exécution en utilisant chacune des APIs.
Note: Confusion possible avec UTF-8
Du au fait que les noms des jeux de charactères dans MySQL ne contiennent pas de tiret, la chaîne "utf8" est correcte dans MySQL et définira le jeu de charactère en UTF-8. La chaîne "utf-8" n'est pas correcte, et utiliser "utf-8" échouera à modifier le jeu de charactère.
Exemple #2 Exemple de définition du jeu de caractères : mysqli
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
printf("Jeu de charactère initial : %s\n", $mysqli->character_set_name());
if (!$mysqli->set_charset('utf8')) {
printf("Erreur lors du chargement du jeu de caractères utf8 : %s\n", $mysqli->error);
exit;
}
echo "Nouvelle information du jeu de charactère :\n";
print_r( $mysqli->get_charset() );
?>
Exemple #3 Exemple de définition du jeu de caractères : pdo_mysql
Note : Ceci ne fonctionnera qu'à partir de PHP 5.3.6.
<?php
$pdo = new PDO("mysql:host=localhost;dbname=world;charset=utf8", 'my_user', 'my_pass');
?>
Exemple #4 Exemple de définition du jeu de caractères : mysql
<?php
$conn = mysql_connect("localhost", "my_user", "my_pass");
$db = mysql_select_db("world");
echo 'Jeu de charactère initial : ' . mysql_client_encoding($conn) . "\n";
if (!mysql_set_charset('utf8', $conn)) {
echo "Erreur : Impossible de définir le jeu de caractères.\n";
exit;
}
echo 'Jeu de caractères courant : ' . mysql_client_encoding($conn);
?>