Changement de version de MariaDB

Le système de base de données MariaDB que nous utilisons est régulièrement mis à jour. Dans de rares cas ou lors de mises à jour importantes, il peut y avoir des changements qui nécessitent des adaptations dans votre application. Dans cet article, nous vous informons des changements actuels.

Mise à jour de MariaDB 10.3 vers 10.6

La mise à jour de MariaDB vers la version 10.6 entraîne quelques changements, mais pas tous les sites Web sont concernés. Si vous maintenez vos sites Web et leurs plugins à jour, vous ne devriez rien remarquer de ce changement. Si, contre toute attente, vous deviez rencontrer des problèmes de fonctionnalité sur votre site Web, nous avons résumé pour vous quelques nouveautés importantes dans les paragraphes suivants.

OFFSET

Les applications écrites à la main ou très anciennes avec accès à la base de données peuvent être concernées par ce changement.

Le nom OFFSET (non sensible à la casse) est un nouveau mot-clé réservé sous MariaDB 10.6. Assurez-vous que tous les identifiants (p. ex. noms de base de données, de tables et de colonnes) portant ce nom soient toujours placés correctement entre des backticks (` `).

Exemple:

MariaDB [user_mydb]> SELECT `offset` FROM `mytable`;
+--------+
| offset |
+--------+
|     10 |
+--------+
1 row in set (0.000 sec)

Vous trouverez plus d'informations à ce sujet sur le site officiel de MariaDB:

Dans un de ces cas, nous vous recommandons de prendre directement contact avec le fournisseur de votre application ou du plugin, car l'adaptation ne peut pas être prise en charge par Hostpoint du côté du serveur.

UTF-8 charset

Dans la version 10.6 de MariaDB le charset «utf8» a été renommé en «utf8mb3» et l'alias correspondant a été ajouté. La fonctionnalité elle-même n'a pas changé. Vous n'avez rien besoin de changer sur le server ou dans les bases de données. Cependant, si une application requiert précisément l'encodage «utf8», cela peut causer des problèmes et empêcher votre site de fonctionne comme il faut. Vous pouvez généralement résoudre ces problèmes de manière facile et permanente en remplaçant simplement la mention «utf8" par la mention «utf8mb3» dans le code. Et dans ce cas, nous vous conseillons de prendre contact avec le fabricant de l'application ou du plugin, vu que depuis Hostpoint nous ne pouvons effectuer aucun changement sur le serveur.

Pour plus d'informations, merci de consulter le site Web officiel de mariaDB (lien en anglais):

https://mariadb.com/kb/en/upgrading-from-mariadb-10-5-to-mariadb-10-6/#character-sets

Versions obsolètes de TYPO3

Les versions de TYPO3 affectées par ce changement sont des versions obsolètes qui ont une exigence stricte en matière d'encodage des caractères (CHARSET). Cependant, seules les installations TYPO3 antérieures à la version 9.5 (LTS) sont concernées, et celles-ci ne sont plus supportées par le fabricant. Veuillez noter qu'une extension de support payante du fabricant est nécessaire pour continuer à recevoir les mises à jour de la version 9.5.

Les versions 9.5 et antérieures de TYPO3 ne reçoivent plus de mises à jour de la part du fabricant, ou seulement si vous payez pour l'extension du support. Par conséquent, nous vous recommandons vivement de mettre à jour vos instances vers la version 11 ou une version plus récente. Cela permettra de combler les lacunes en matière de sécurité et d'assurer la compatibilité avec d'autres systèmes et technologies tels que MariaDB 10.6 ou les nouvelles versions de PHP. La mise à jour vers la version 11 ou une version plus récente est fournie gratuitement par le fabricant.

Si l'encodage des caractères est mal réglé, vous pouvez l'ajuster vous-même en modifiant le fichier de configuration de TYPO3 où est défini le CHARSET. Pour ce faire, retrouvez le fichier LocalConfiguration.php dans votre installation TYPO3. Celui-ci se trouve généralement dans le dossier typo3conf au niveau racine de votre site Web. Dans ce fichier vous devriez trouver un bloc de code à peu près comme suit:

~/typo3conf/LocalConfiguration.php


    'DB' => [
        'Connections' => [
            'Default' => [
                'charset' => 'utf8'

Changez la mention «utf8» en «utf8mb3» et sauvegardez le fichier:

~/typo3conf/LocalConfiguration.php


    'DB' => [
        'Connections' => [
            'Default' => [
                'charset' => 'utf8mb3'

Si vous ne trouvez pas le bloc ci-dessus dans la configuration, cela veut dire que vous utilisez une version trop vieille de TYPO3 où cette solution n'est pas possible. Dans ce cas vous devrez absolument mettre à jour votre site Web vers une version plus récente.

Pour plus d'informations sur les versions supportées et leurs configurations requises, vous pouvez consulter le site Web de TYPO3 (en anglais):

Magento

Magento a des spécifications strictes concernant les versions de MariaDB qui sont compatibles avec telle ou telle version de Magento.Vous trouverez ici des indications sur les versions ainsi que sur leurs spécifications:

A partir de la version 2.4.6, sortie en mars 2023, MariaDB 10.6 sera également supportée. Vous pouvez contourner la restriction de mise à jour ou d'installation de la version 2.4.5 ou plus ancienne sous MariaDB 10.6 à l'aide des variantes de procédure suivantes. Avec ces deux variantes, la mise à jour et l'installation devraient à nouveau fonctionner sans problème.

Veuillez noter que ces solutions n'ont pas été officiellement confirmées par l'éditeur de Magento, mais qu'elles se sont établies dans la pratique courante comme des solutions de contournement temporaires. Nous vous recommandons néanmoins de passer à la version 2.4.6 de Magento dès que possible.

Variante 1 - adapter «di.xml»

Une variante pour contourner le problème est d'adapter le fichier di.xml correspondant, dans lequel la version de MariaDB est définie. Pour cela, vous devez trouver le fichier di.xml dans votre installation Magento. Celui-ci se trouve généralement dans le répertoire principal de votre site Web. Dans ce fichier, vous devriez trouver le schéma suivant (ou un schéma similaire):

~/di.xml


<type name="Magento\Framework\DB\Adapter\SqlVersionProvider">
	<arguments>
		<argument name="supportedVersionPatterns" xsi:type="array">
			<item name="MariaDB-(10.2-10.4)" xsi:type="string">^10\.[2-4]\.</item>
		</argument>
	</arguments>
</type>

Adaptez maintenant ce schéma comme suit et enregistrez le fichier:

~/di.xml


<type name="Magento\Framework\DB\Adapter\SqlVersionProvider">
	<arguments>
		<argument name="supportedVersionPatterns" xsi:type="array">
			<item name="MariaDB-(10.2-10.6)" xsi:type="string">^10\.[2-6]\.</item>
		</argument>
	</arguments>
</type>

Variante 2 - Modul Composer

Une autre variante consiste à utiliser un module composer correspondant. Cette variante a l'avantage que la modification reste valable même après une mise à jour.

Vous trouverez le module et d'autres informations ici:

https://github.com/Sental/db-override

Plus d'informations

Vous trouverez plus d'informations sur les nouveautés ainsi que le guide de migration officiel sur le site Web de MariaDB:

Si vous rencontrez des problèmes techniques lors de la modification, veuillez prendre contact avec notre support afin que nous puissions trouver une solution.

Nous nous ferons un plaisir de vous aider grâce à notre expérience.

Les mises à jour régulières préservent les nerfs

De manière générale, il est préférable de rester à jour en matière de technologie. Celui qui actualise son CMS régulièrement et à intervalles rapprochés a un net avantage, et pas seulement en matière de sécurité. Si l'on n'impose pas à son CMS de grands sauts de version (ou des sauts trop importants), on minimise aussi énormément les risques lors des mises à jour. La plupart du temps, les modifications effectuées lors de la mise à jour d'une version à la suivante (par ex. de 2.3 à 2.4 ou de 1.8.2 à 1.8.3) sont gérables, bien testées et prévues par les développeurs. Les thèmes et les plug-ins utilisés résistent généralement sans dommage à ces petites étapes de mise à jour.

Le risque augmente si l'on prend du retard dans les mises à jour. Dans ce cas, de nombreuses petites modifications mineures peuvent peu à peu s'accumuler pour former des incompatibilités ou des dépendances - qui ne peuvent être résolues qu'avec beaucoup d'efforts. Une situation de stress désagréable peut alors survenir brusquement lorsque l'on est contraint de changer de version de MariaDB. C'est pourquoi nous recommandons aux administrateurs de sites web de s'y tenir régulièrement, sans trop d'efforts, et de prévenir ainsi les gros problèmes de mise à jour.

Remarque: Nous vous recommandons de faire une sauvegarde de la situation actuelle avant chaque mise à jour.

Vous pouvez créer gratuitement une sauvegarde via le Control Panel Hostpoint et la restaurer en cas d'urgence. Les restaurations effectuées par le support peuvent entraîner des frais.

Merci de n'utiliser ce formulaire que pour donner du feedback sur la procédure ci-dessus.
Pour envoyer une demande d'assistance au support, merci d'utiliser ce formulaire-ci.