« Support unicode complet pour MySQL » : différence entre les versions
(Création de la page) |
(Traduction (il en reste à faire...)) |
||
| Ligne 2 : | Ligne 2 : | ||
==UTF-8== | ==UTF-8== | ||
UTF-8 | UTF-8 est un encodage de caractères utilisé par la plupart des sites. It encodes each of the 1,112,064 valid code points. To store all of this information, four bytes is required. The most popular values are in the three byte region. MySQL by default only uses a three byte encoding and so values in the four byte range can not be stored. Any record that contains a four byte character will not be saved. | ||
MySQL | MySQL permet un support unicode (UTF-8) complet. Cela nécessite de configurer certains réglages. Depuis Moodle 3.3, par défaut le support UTF-8 complet sera assuré pour MySQL et MariaDB. Les bases de données existantes fonctionneront toujours avec le support partiel, mais il est recommandé de passer au support complet. | ||
Moodle comes with a Command Line Interface (CLI) script for converting to full UTF-8 for MySQL (and MariaDB). Before Moodle 3.3 this conversion tool would only change the collation to some variant of 'utf8_bin'. 'utf8_unicode_ci' was the recommended collation. We now recommend 'utf8mb4_unicode_ci'. 'utf8mb4_unicode_ci' supports 4 byte characters (utf8_unicode_ci only supports 3 byte characters) so four byte characters such as Asian characters and emoji should now be fully supported. | Moodle comes with a Command Line Interface (CLI) script for converting to full UTF-8 for MySQL (and MariaDB). Before Moodle 3.3 this conversion tool would only change the collation to some variant of 'utf8_bin'. 'utf8_unicode_ci' was the recommended collation. We now recommend 'utf8mb4_unicode_ci'. 'utf8mb4_unicode_ci' supports 4 byte characters (utf8_unicode_ci only supports 3 byte characters) so four byte characters such as Asian characters and emoji should now be fully supported. | ||
Ce script essayera de modifier l'interclassement de la base de données, l'encodage des caractères et les réglages par défaut des tables. | |||
En résumé : | En résumé : | ||
| Ligne 18 : | Ligne 18 : | ||
=== Format de fichier === | === Format de fichier === | ||
To allow for large indexes on columns that are a varchar, a combination of settings needs to be set. The file format for the system needs to be using "Barracuda". This allows for the row format to be set to "Compressed" or "Dynamic". | To allow for large indexes on columns that are a varchar, a combination of settings needs to be set. The file format for the system needs to be using "Barracuda". This allows for the row format to be set to "Compressed" or "Dynamic". Pour activer ce réglage, voyez les ''Étapes de mise à jour'' ci-dessous. | ||
=== Fichier par table === | === Fichier par table === | ||
Pour activer ce réglage, voyez les ''Étapes de mise à jour'' ci-dessous. | |||
===Large prefix=== | ===Large prefix=== | ||
This in conjunction with the row format being either "Compressed" or "Dynamic" allows for large varchar indexes above 191 characters. | This in conjunction with the row format being either "Compressed" or "Dynamic" allows for large varchar indexes above 191 characters. | ||
Pour activer ce réglage, voyez les ''Étapes de mise à jour'' ci-dessous. | |||
== Étapes de mise à jour == | == Étapes de mise à jour == | ||
| Ligne 33 : | Ligne 33 : | ||
'''Important''' : effectuez une sauvegarde complète (de votre base de données) avant d'effectuer des changements ou de lancer le script ! | '''Important''' : effectuez une sauvegarde complète (de votre base de données) avant d'effectuer des changements ou de lancer le script ! | ||
* | * Modifiez les réglages de configuration pour MySQL (idem pour MariaDB). Cette étape est optionnelle. Vous pouvez lancer le script et il essayera de faire toutes les modifications par lui-même. si des erreurs se produisent, essayez de modifier manuellement ces réglages somme indiqué ci-dessous. | ||
** | ** Sur les systèmes basés sur Linux vous devrez modifier le fichier my.cnf. Il est situé dans '/etc/mysql/'. | ||
** | ** Faites les modifications suivantes au fichier my.cnf : | ||
<code> | <code> | ||
[client] | [client] | ||
Version du 10 mars 2017 à 16:15
UTF-8
UTF-8 est un encodage de caractères utilisé par la plupart des sites. It encodes each of the 1,112,064 valid code points. To store all of this information, four bytes is required. The most popular values are in the three byte region. MySQL by default only uses a three byte encoding and so values in the four byte range can not be stored. Any record that contains a four byte character will not be saved.
MySQL permet un support unicode (UTF-8) complet. Cela nécessite de configurer certains réglages. Depuis Moodle 3.3, par défaut le support UTF-8 complet sera assuré pour MySQL et MariaDB. Les bases de données existantes fonctionneront toujours avec le support partiel, mais il est recommandé de passer au support complet.
Moodle comes with a Command Line Interface (CLI) script for converting to full UTF-8 for MySQL (and MariaDB). Before Moodle 3.3 this conversion tool would only change the collation to some variant of 'utf8_bin'. 'utf8_unicode_ci' was the recommended collation. We now recommend 'utf8mb4_unicode_ci'. 'utf8mb4_unicode_ci' supports 4 byte characters (utf8_unicode_ci only supports 3 byte characters) so four byte characters such as Asian characters and emoji should now be fully supported.
Ce script essayera de modifier l'interclassement de la base de données, l'encodage des caractères et les réglages par défaut des tables.
En résumé :
- Les installations neuves de Moodle 3.1.5 et 3.2.2 et ultérieures utiliseront utf8mb4 par défaut.
- Les sites mis à jour vers Moodle 3.1.5 ou 3.2.2 peuvent utiliser le script pour mettre à jour vers utf8mb4.
- Dans Moodle 3.3, si la base de données n'est pas configurée pour le support UTF-8 complet, un avertissement sera affiché et encouragera à passer à utf8mb4, mais vous pourrez continuer à utiliser utf8 comme avant.
Format de fichier
To allow for large indexes on columns that are a varchar, a combination of settings needs to be set. The file format for the system needs to be using "Barracuda". This allows for the row format to be set to "Compressed" or "Dynamic". Pour activer ce réglage, voyez les Étapes de mise à jour ci-dessous.
Fichier par table
Pour activer ce réglage, voyez les Étapes de mise à jour ci-dessous.
Large prefix
This in conjunction with the row format being either "Compressed" or "Dynamic" allows for large varchar indexes above 191 characters. Pour activer ce réglage, voyez les Étapes de mise à jour ci-dessous.
Étapes de mise à jour
Important : effectuez une sauvegarde complète (de votre base de données) avant d'effectuer des changements ou de lancer le script !
- Modifiez les réglages de configuration pour MySQL (idem pour MariaDB). Cette étape est optionnelle. Vous pouvez lancer le script et il essayera de faire toutes les modifications par lui-même. si des erreurs se produisent, essayez de modifier manuellement ces réglages somme indiqué ci-dessous.
- Sur les systèmes basés sur Linux vous devrez modifier le fichier my.cnf. Il est situé dans '/etc/mysql/'.
- Faites les modifications suivantes au fichier my.cnf :
[client]
default-character-set = utf8mb4
[mysqld]
innodb_file_format = Barracuda
innodb_file_per_table = 1
innodb_large_prefix
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysql]
default-character-set = utf8mb4
- Redémarrez votre serveur MySQL
- Lancez le script en ligne de commande pour convertir au nouveau codage de caractère et interclassement (nécessite Moodle 3.1.5, 3.2.2 ou plus récent) : php admin/cli/mysql_collation.php --collation=utf8mb4_unicode_ci
La mise à jour est maintenant terminée.
