A.7 Migration de Joomla! 1.0.x vers Joomla! 1.5

Certains parmi vous gèrent des sites Web basés sur la version précédente 1.0 de Joomla! ou sur
Mambo 4.5.x. Vous voulez migrer vers Joomla!.

Voici les quelques règles à respecter :

1. Avant tout, la totalité des données du site Web doit être sauvegardée.
2. Actualisation des fichiers de code source communs.
3. Actualisation des composants, modules et mambots complémentaires.
4. Actualisation ou propagation éventuelle des modifications de programmes faites par vous.
5. Test de compatibilité des données avec le nouvel environnement.
6. Conversion des contenus au format de codage des caractères UTF8.

Vous en déduisez que moins votre configuration est personnalisée par des composants spécifiques,
plus la migration sera rapide et simple. Il n’existe pas de règle unique de mise à jour. Vous devez
donc recueillir le maximum d’informations pour établir sur papier un plan de migration individualisé
de votre site Web.

Figure A.2 Modification du mot de passe.

Sauvegarde des données du site

Avant tout essai de migration, vous devez créer une sauvegarde de vos données. Servez-vous de l’outil de sauvegarde proposé par votre hébergeur pour créer un vidage (dump) MySQL. Dans la plupart des cas, vous utiliserez phpMyAdmin (l’outil choisi dans XAMPPLITE). Cliquez sur le bouton de la page EXPORTER, sélectionnez toutes les tables de votre base (cliquez sur le lien TOUT SÉLECTIONNER) et activez toutes les cases du groupe d’options STRUCTURE. Dans le groupe DONNÉES, cochez INSERTIONS COMPLÈTES. Dans le groupe du bas, TRANSMETTRE, choisissez le format de sortie. Si l’hébergeur l’autorise, optez pour le format compressé (« zippé ») qui permet d’économiser à peu près 95 % d’espace ! Validez vos choix en cliquant sur le bouton EXÉCUTER (voir Figure A.3).
Les tables de données sont copiées de la base dans le fichier archive qui est alors proposé en téléchargement (même localement). Cette archive contient toutes les requêtes SQL permettant de
reconstruire les tables dans une nouvelle base avec tous les contenus. C’est la meilleure solution
de sauvegarde des données du site.

Figure A.3 Sauvegarde d’une base MySQL dans phpMyAdmin.

Si vous avez besoin de restaurer la base en cas d’avarie ou de la dupliquer, dans phpMyAdmin,
cliquez sur le bouton IMPORTER (voir Figure A.4), désignez le fichier d’archive via le bouton PARCOURIR et cliquez sur EXÉCUTER. Toutes les requêtes SQL sont exécutées dans l’ordre adéquat, puis les données sont injectées dans les tables (voir Figure A.5).

A.7.1 Sauvegarde des fichiers sources

En plus des données d’exploitation, vous devez aussi sauvegarder les fichiers de code source. Avec
votre outil client FTP habituel, faites une copie de la totalité du dossier d’installation de Joomla!.

A.7.2 Le script de migration

Vous devez d’abord installer un composant de migration dans l’ancienne version 1.0.x de Joomla!. Grâce à lui, vous pouvez générer trois fichiers compressés .zip en cliquant sur le lien DUMP IT :

• une sauvegarde complète du site Web ;
• une sauvegarde des composants du noyau ;
• une sauvegarde des composants additionnels.

Figure A.4 La page d’importation MySQL.

Figure A.5 Sélection de l’archive de sauvegarde.

Rangez ces fichiers en lieu sûr. Ils contiennent les données initiales non modifi ées de votre site Web Joomla! en version 1.0.x, notamment au niveau du codage des caractères !

A.7.3 Nouvelle installation de Joomla! 1.5.0

Créez un dossier puis copiez-y tous les fichiers de Joomla! 1.5.0.
Configurez l’installation de Joomla! 1.5.0 comme expliqué au Chapitre 2 pour arriver jusqu’à l’étape
6 (voir Figure A.6).

Figure A.6 Commande de migration de site.

Activez l’option CHARGER LE SCRIPT DE MIGRATION. Saisissez l’ancien préfi xe de base de données (souvent mos_ ou jos_) puis sélectionnez l’ancien codage des caractères (dans ENCODAGE ANCIEN SITE). Si vous n’êtes pas sûr de votre réponse, ouvrez un fichier de langues et cherchez la valeur de la variable _ISO.

Toujours dans la même page, désignez le fichier de sauvegarde des composants du noyau puis cliquez
sur le bouton TRANSFÉRER ET EXÉCUTER.

La suite dépend de la nature de votre site. Vous devriez voir apparaître un message de bonne fin
d’exécution de la conversion des données. Si une erreur survient en rapport avec la base de données,
ce n’est souvent pas grave. Essayez de bien comprendre l’origine probable du problème et corrigez
la situation via l’interface phpMyAdmin. (Les sites utilisant beaucoup de composants additionnels
rencontrent plus souvent des problèmes de migration.)

Dans tous les cas, terminez correctement le processus de configuration en indiquant le nom du site
et le mot de passe de l’administrateur.

Que s’est-il passé ?

Tous les composants du noyau (com_content, com_weblinks, com_banner, com_contact, com_newsfeed, com_poll et com_users) ont été mis à jour.

Les liens de menus de ces composants ont été adaptés. Les modules ont cependant été au départ marqués comme dépubliés. La position d’affichage et les paramètres doivent encore être vérifi és et adaptés.

Aucun composant additionnel n’a été pris en compte, ni aucun fichier externe (bannières, images,
fichiers PDF, etc.).

A.7.4 Variante de migration manuelle

Passons aux mauvaises nouvelles. Vous ne pouvez pas réussir la modification des tables par phpMyAdmin, parce que les lettres accentuées ne sont pas correctement converties lors du basculement
de l’encodage ! Toutes les données sont récupérées, mais les lettres accentuées et signes spécifiques de l’ASCII (à, é, è, ù, ç, etc.) sont mal affichés.

Il faut faire transiter les données par une exportation vers le format UTF8 et retoucher quelque peu
la structure des tables. L’exportation se fait aisément dans phpMyAdmin.

Pensez à activer la case de l’option INSERTIONS COMPLÈTES.

Les données exportées doivent être stockées dans le format UTF8 avec un éditeur qui en est capable.
(Si le volume de données reste réduit, le Bloc-notes de Windows fera l’affaire.)

Adaptation du schéma de la base de Joomla! 1.5

Il n’y a réellement que deux champs de données à renommer :

• dans la table jos_core_acl_aro, le champ aro_id se nomme dorénavant id ;

• dans la table jos_core_acl_aro_groups, le champ group_id se nomme dorénavant id.

Importation des tables

Voici la liste des tables pouvant être importées :

• jos_banner ;
• jos_bannerclient ;
• jos_bannerfinish ;
• jos_categories ;
• jos_contact_details ;
• jos_content ;
• jos_content_frontpage ;
• jos_content_rating ;
• jos_core_acl_aro ;
• jos_core_acl_groups_aro_map ;
• jos_core_log_items ;
• jos_core_log_searches ;
• jos_messages ;
• jos_messages_cfg ;
• jos_newsfeeds ;
• jos_poll_data ;
• jos_poll_date ;
• jos_poll_menu ;
• jos_polls ;
• jos_sections ;
• jos_users ;
• jos_weblinks.

La table jos_usertypes n’est plus utilisée dans Joomla! 1.5.

Les menus et les modules peuvent être reconfi gurés via phpMyAdmin ou via l’interface d’administration.

Et vous en avez fini avec la migration.

La migration des composants tiers est moins aisée, mais il est certain que des scripts de migration
vont apparaître sous peu.

Si l’on excepte le changement d’encodage, il n’y a pas eu de changement notable au niveau des
tables. L’essentiel du travail de l’équipe de développement a concerné le code source des composants
notamment pour les adapter à la nouvelle version.

Vous trouverez un guide de migration complet sur joomla.org.