Migration Joomla à l’aide de FileZilla et phpMyAdmin
Introduction
Ce tutoriel décrit comment déplacer une installation Joomla existante vers un espace web hosting.fr en utilisant SFTP et phpMyAdmin. Comme alternative à ce tutoriel, vous pouvez consulter le tutoriel “Migration Joomla par sauvegarde et restauration avec un plugin de sauvegarde”, qui est plus facile à mettre en œuvre pour les débutants.
Ce tutoriel ne traite que du déménagement de Joomla. Comment déplacer également votre domaine est décrit ailleurs.
Dans ce tutoriel, nous procederons comme suit :
- Exportation des données de la base de données à l’aide de phpMyAdmin chez l’ancien fournisseur d’hébergement
- Importation des données de la base de données à l’aide de phpMyAdmin chez hosting.fr
- Téléchargement des données depuis l’espace web à l’aide de FileZilla via SFTP ou FTP
- Modification du fichier de configuration pour ajuster les informations d’identification de la base de données
- Téléversement des données sur le nouvel espace web chez hosting.fr
Étape 1 : Vérification des prérequis
- Vous disposez déjà d’une installation Joomla existante chez un fournisseur dont vous souhaitez migrer vers hosting.fr.
- Le logiciel phpMyAdmin est disponible chez votre ancien fournisseur et vous connaissez les informations d’identification de la base de données MySQL / MariaDB utilisée.
- Vous connaissez les informations d’identification FTP ou SFTP de votre ancien fournisseur. Normalement, après connexion, vous pouvez trouver ces informations dans l’interface client de votre fournisseur.
- Vous disposez d’un espace web et d’une base de données chez hosting.fr que vous pouvez utiliser pour Joomla.
Étape 2 : Migration du contenu de la base de données à l’aide de phpMyAdmin
Pour migrer le contenu de la base de données, l’utilisation de l’outil phpMyAdmin est recommandée. phpMyAdmin est une interface graphique web pour éditer le contenu d’une base de données MySQL / MariaDB, mais permet aussi d’exporter ou d’importer l’intégralité du contenu de la base de données.
Exportation de la base de données
L’outil phpMyAdmin est déjà installé chez la plupart des fournisseurs et est accessible via l’interface client. Alternativement, il peut également être installé manuellement.
Accédez à phpMyAdmin.
Connectez-vous à phpMyAdmin :
Après la connexion, vous arrivez sur la page suivante :
Si vous avez souscrit à un simple hébergement web, vous ne trouverez que deux liens vers des bases de données dans la navigation à gauche. La base de données “information_schema” ne contient que des métadonnées et ne nous intéresse pas davantage. Sélectionnez donc l’autre base de données. Vous devriez maintenant voir les tables de Joomla comme dans l’image suivante :
Cliquez ici sur “Exporter”.
Veuillez sélectionner l’option “rapide” et le format “SQL”. Cliquez ensuite sur “OK”. Enregistrez le fichier qui vous est proposé pour téléchargement sur votre ordinateur.
Importation de la base de données
Accédez à phpMyAdmin. Vous pouvez trouver comment accéder à l’outil chez hosting.fr dans “Où trouver phpMyAdmin?”. Comment trouver les informations d’identification chez ###COMPANY-NAME### est décrit dans l’article “Où trouver mes informations d’identification pour ma base de données?”.
Connectez-vous à la section phpMyAdmin de hosting.fr :
Après la connexion, vous arriverez également sur la page suivante :
Si vous avez souscrit à un simple hébergement web, vous ne trouverez que deux liens vers des bases de données dans la navigation à gauche. La base de données “information_schema” ne contient que des métadonnées et ne nous intéresse pas davantage. Sélectionnez donc l’autre base de données, qui commence par le préfixe “db”. Vous accéderez à l’affichage suivant :
Sélectionnez l’option “Importer”.
Cliquez sur “Parcourir …” et choisissez le fichier MySQL-Dump de votre ordinateur. Cliquez ensuite sur “OK” pour importer les données. Un message “L’importation a été effectuée avec succès.” devrait apparaître. Sur le côté gauche dans phpMyAdmin, les tables importées pour Joomla devraient maintenant apparaître. L’importation des données de la base de données dans la nouvelle base de données est donc terminée.
Configuration de Filezilla et téléchargement des fichiers depuis l’ancien espace web
Pour transférer les fichiers de l’ancien fournisseur vers hosting.fr, téléchargez-les d’abord à l’aide du client FTP ou SFTP FileZilla avec les informations d’identification que vous avez reçues de votre ancien fournisseur. Le client FileZilla peut être téléchargé depuis le site web du projet FileZilla pour Windows, OSX ou Linux. Nous recommandons d’établir la connexion dans FileZilla via le “Protocole de transfert de fichiers SSH” (SFTP). Si ce protocole n’est pas disponible, FTP peut également être utilisé. Dans ce cas, les données seront cependant transmises non chiffrées sur Internet.
Création d’un profil serveur et établissement de la connexion à l’espace web dans FileZilla
Nous allons d’abord créer un profil serveur pour votre ancien fournisseur :
- Lancez l’outil FileZilla. Créez un nouveau profil serveur dans le “Gestionnaire de serveur” sous “Fichier” > “Gestionnaire de serveur”.
Cliquez sur “Nouveau serveur”.
Sélectionnez le “Protocole de transfert de fichiers SSH” (SFTP). Si SFTP n’est pas disponible chez votre ancien fournisseur, veuillez choisir FTP.
Saisissez sous “Serveur” l’adresse du serveur de l’ancien fournisseur.
Choisissez le port qui vous a été indiqué par votre fournisseur. Si aucun port ne vous a été communiqué, veuillez sélectionner le port 22. Si SFTP n’est pas disponible chez votre ancien fournisseur et que vous devez opter pour FTP comme méthode de transfert, veuillez choisir le port 21.
Saisissez le nom d’utilisateur et le mot de passe pour l’espace web.
Pour une meilleure lisibilité, vous pouvez donner un nom au profil serveur, par exemple “ancien fournisseur Joomla”, en sélectionnant le profil dans l’arborescence à gauche et en appuyant sur “F2”.
Ensuite, créez un autre profil serveur pour le nouveau espace web hosting.fr. Vous pouvez trouver comment obtenir les informations d’identification dans l’article “Où trouver mes informations d’identification FTP/SFTP?”.
Cliquez à nouveau sur le bouton “Nouveau serveur”.
Sélectionnez le “Protocole de transfert de fichiers SSH” (SFTP).
Saisissez sous “Serveur” l’adresse du serveur que vous trouvez dans la gestion “Utilisateurs FTP/SSH/Statistiques” de votre paquet d’hébergement web hosting.fr.
Sélectionnez le port 2244.
Saisissez le nom d’utilisateur et le mot de passe pour l’espace web.
Pour une meilleure lisibilité, vous pouvez donner un nom au profil serveur, par exemple “hosting.fr Joomla”, en sélectionnant le profil dans l’arborescence à gauche et en appuyant sur “F2”.
Cliquez finalement sur “OK”.
- FileZilla vous demandera si vous souhaitez enregistrer le mot de passe pour votre espace web. Sélectionnez “Enregistrer le mot de passe”. Cependant, nous recommandons de stocker le mot de passe de manière chiffrée en choisissant un mot de passe principal.
Téléchargement des fichiers depuis l’ancien fournisseur
Lancez à nouveau le gestionnaire de serveur. Sélectionnez le profil de votre ancien fournisseur et cliquez sur “Connecter”. Si vous avez défini un mot de passe principal pour FileZilla, vous serez peut-être alors questionné à ce sujet.
FileZilla vous demandera ensuite si vous faites confiance à l’empreinte cryptographique du serveur. Veuillez sélectionner “Faire toujours confiance à ce serveur, enregistrer cette clé.”
Une fois la connexion établie, veuillez naviguer dans la liste de fichiers et de dossiers à droite jusqu’à ce que vous trouviez les fichiers montrés dans l’image suivante et ainsi que le répertoire racine de Joomla chez votre ancien fournisseur.
Sélectionnez tous les fichiers à droite. Cliquez alors avec le bouton droit de la souris sur les fichiers et choisissez “Télécharger”. Le téléchargement des fichiers commence et la progression pour chaque fichier est affichée en bas de l’écran.
Patientez jusqu’à ce que le téléchargement des fichiers soit terminé. Ensuite, déconnectez-vous du serveur SFTP :
Les fichiers ne seront téléchargés sur le nouvel espace web qu’après modification du fichier de configuration de l’installation Joomla dans l’étape suivante.
Ajustement des fichiers de configuration pour la nouvelle base de données
Comme les informations d’identification de la base de données, c’est-à-dire notamment le nom d’utilisateur et le mot de passe, chez hosting.fr sont différentes de celles de l’ancien fournisseur, elles doivent être modifiées dans les fichiers de configuration avant le téléversement. Pour ce faire, le fichier configuration.php doit être édité avec un éditeur de texte. Nous recommandons d’utiliser l’éditeur Visual Studio Code de Microsoft. Il peut être téléchargé gratuitement par Microsoft et est disponible pour tous les systèmes d’exploitation courants. Ouvrez le fichier configuration.php avec Visual Studio Code ou tout autre éditeur de texte approprié. Dans le fichier, vous trouverez les lignes suivantes :
public $host = 'mein.datenbank.server.de';
public $user = 'meinDatenbankBenutzer';
public $password = 'meinGeheimesPasswort';
public $db = 'meinDatenbankName';
Veuillez saisir le nom de la base de données, le nom d’utilisateur et le mot de passe pour le serveur de base de données, ainsi que l’adresse du serveur de base de données dans le fichier. Comment trouver les informations d’identification chez hosting.fr est décrit dans l’article “Où trouver mes informations d’identification pour ma base de données?”.
Enfin, enregistrez le fichier.
Téléversement des fichiers vers le nouvel espace web
Une fois que les fichiers de configuration pour la base de données ont été modifiés, les fichiers de l’installation Joomla peuvent être chargés sur le nouvel espace web. Retournez au gestionnaire de serveur et connectez-vous avec le serveur SFTP hosting.fr.
Les fichiers doivent être chargés dans le bon dossier sur le serveur. Normalement, il s’agit du répertoire ./html/<nom de domaine> par rapport au répertoire dans lequel vous atterrissez automatiquement après la connexion à FileZilla. Cela dépend toutefois de la configuration de votre espace web pour PHP et MySQL. Comment la configuration de base de l’espace web pour PHP et MySQL est effectuée est décrit dans l’article “Comment configurer mon domaine et mon espace web pour PHP et MySQL?”.
Sélectionnez tous les fichiers et dossiers téléchargés et téléversez-les sur le serveur.
Conclusion de la migration
Enfin, accédez à votre site Joomla dans le navigateur web et vérifiez toutes les fonctionnalités.
Le backend d’administration de Joomla peut être atteint en ajoutant /administrator/ à la domain dans la barre d’adresse du navigateur, c’est-à-dire par exemple via https://mustermann-domain.de/administrator/.
Si tout fonctionne comme souhaité, la migration du site est alors terminée.
En cas de problème : conseils de dépannage
Si, après la migration, vous ne voyez que le message “Erreur” dans votre nouveau Joomla, vous pouvez modifier l’affichage des erreurs dans le fichier de configuration configuration.php en le changeant de default à maximum. Pour cela, remplacez la ligne
public $error_reporting = 'default';
par
public $error_reporting = 'maximum';
et chargez ensuite le fichier dans le répertoire racine de Joomla avec FileZilla, là où un fichier ayant le même nom existe déjà.
Si vous parvenez à trouver l’erreur, veuillez rétablir cette option.
Si Joomla ne parvient pas à se connecter à la base de données, le message “Warning: session_start(): Failed to read session data: user (path: /tmp) […] Error: Failed to start application: Failed to start the session” peut apparaître. Veuillez alors vérifier une fois de plus les informations d’identification de la base de données.
Il est souvent utile d’entrer le message d’erreur dans un des moteurs de recherche internet appropriés.