Dans ce tutoriel, nous verrons comment passer d’une version locale de site vers une version en ligne. Cette méthode est aussi valable quand vous devez changer de nom de domaine ou déplacer votre site d’un répertoire à un autre ou enfin si vous devez passer une version en ligne vers une version locale. Le plus important sera d’utiliser les URL appropriées (ancien vers nouveau site).
Présentation
Au début d’un projet, il est courant de travailler d’abord en local. Que signifie travailler en local. En fait, vous simulez un serveur web sur votre machine. Il existe de nombreux outils pour réaliser cette opération. Je ne les détaillerai pas, ce n’est pas le but de ce tutoriel.
Il utile de travailler en local pour plusieurs raisons:
- nous n’avons pas besoin de connexion web. Il est possible de travailler sur la plage ou chez Mamie qui n’a pas de connexion internet
- la réponse du serveur est plus rapide pour mettre à jour ou charger les images
- vous utilisez un système de gestion de versions comme Git
Sur Mac, le plus connu est MAMP. Sur PC, c’est WAMP. Les puristes diront qu’il est encore plus performant de réaliser un serveur virtualisé avec des outils comme Virtual Box pour avoir une configuration du serveur local sur mesure, proche de la version en ligne. Je suis d’accord, par contre le niveau de compétence nécessaire n’est pas du même ordre. Voyez ça pour une étape ultérieure.
Exportation depuis la version locale du site
Une fois votre site finalisé, vous désirez migrer cette version vers ce qui sera votre site définitif en ligne, sur votre serveur distant. C’est votre hébergeur qui vous a réservé cet espace. Pour ce faire, vous avez besoin d’éléments incontournables qui font que votre site WordPress fonctionne:
- le dossier WordPress complet que vous avec téléchargé qui comprend la structure complète WordPress et tous les éléments que vous avez ajoutés comme vos thèmes, extensions et médias
- la base de donnée qui fait le lien avec tous les éléments précédents et stocke tout votre contenu de type: texte, réglages, compte, cessions, liens…
Exportation du dossier WordPress
En vous connectant à votre site par FTP ou mieux par SFTP, vous allez d’abord charger tout le contenu de votre site. Attention, vous devez placer tout le contenu du dossier à la racine et non le dossier WordPress.
Quand j’entends à la racine, c’est le dossier de votre serveur vers lequel pointera votre nom de domaine. Le réglage est effectué par l’hébergeur. Ce dossier n’a pas toujours le même nom. Les intitulés les plus courants sont: www, public_html, htdocs.
Exportation de la base de données
Pour exporter la base de données, vous devez d’abord vous connecter à l’interface web de PHPMyAdmin depuis votre serveur local. Ensuite, vous sélectionnez la base à exporter. Il se peut votre l’interface soit un peu différente de mes captures d’écran. Pour information, j’ai sélectionné le thème pmahomme dans les paramètres d’affichage de PHPMyAdmin.
Une fois la base sélectionnée (ici elle s’appelle wordpress1), tous les tableaux de votre site vont apparaîtres. Ici le préfixe par défaut wp_ a été changé en 1404gregoiretheme_. Cette nuance est importante à noter quand vous ferez la migration. C’est un paramètre que l’on choisit au moment de l’installation de WordPress. Si vous avez celui par défaut, gardez-le.
Ensuite, après avoir cliqué sur Exporter, voici les seuls paramètres à changer:
- Méthode d’exportation: choisir Personnalisée
- Tables: choisir Tout sélectionner. C’est la valeur par défaut
- Sortie: choisir Diriger la sortie vers un fichier, changer juste Compression et prenez gzippé
Et c’est tout pour les réglages. Ensuite et enfin, tout en bas vous cliquez sur Exécuter pour télécharger la base de données archivée. C’est cette même base qui nous servira pour faire la migration vers notre site en ligne.
Importation en ligne de la version locale
Nous avons tous les éléments (dossier WordPress et base de données) pour faire la migration en ligne. La partie qui va suivre ne sera pas forcément identique à la vôtre selon votre hébergeur, mais le principe sera le même.
Information de votre base de données
Cette information vous a été donnée lors de la création de la base donnée chez votre hébergeur. La plupart du temps, vous l’avez reçue par email. Dans ce cadre, nous avons besoin des éléments suivants pour votre base:
- Nom: dans ma capture c’est wordpress1
- Utilisateur
- Mot de passe
- Adresse de l’hébergement. Le plus souvent c’est localhost, mais chez OVH par exemple vous pourrez avoir quelque chose du style
mysql51-100.bdb. C’est toute cette adresse qu’il faudra utiliser.
Une fois ces éléments obtenus vous allez modifier le fichier wp-config.php à la racine de votre site en insérant les éléments vus précédemment. Vous aurez à nouveau besoin de vous connecter en FTP en utilisant un éditeur de texte.
Attention à ne pas supprimer un des guillemets simples ou à ne pas mettre d’espace entre ces guillemets.
Importation de la base de données
Puisque vous venez de créer une nouvelle base sur votre serveur, elle doit être vide, sans aucun tableau. Si cette base avait déjà des tableaux, il est préférable de tout supprimer.
Pour supprimer, vous devez respecter ces étapes:
- Tout cocher (les tableaux)
- Pour la sélection, choisissez Supprimer
- Confirmer par Oui à l’étape suivante
Ensuite, en cliquant sur Importer on vous demandera pour Parcourir pour choisir un fichier sur votre ordinateur. Vous exécutez cette commande sans toucher aux autres réglages par défaut et vous sélectionnerez la base de données exportée depuis votre installation locale.
Votre base de données est importée. Il reste juste à mettre à jour toutes les URL de votre ancien site pour les faire correspondre au nouveau.
Mise à jour de la base de données
C’est la dernière partie à réaliser avant la vérification du nouveau site en ligne. Il s’agit de mettre à jour toutes les URL de votre site. Que ce soit de la version locale vers celle en ligne, ou inversement, vos URL ont été modifiées. Il les mettre à jour dans votre base de données.
Pour ce faire, vous pouvez utiliser le script de search and replace dont je détaille l’utilisation dans ce tutoriel WordPress sur Interconnnectit ou cet autre script DBSR. Dans le premier, une vidéo retrace toutes les étapes.
Connexion au site
La migration est presque terminée. Il s’agit de vérifier si tout fonctionne correctement quand vous vous connectez à votre site.
Parfois, vous pouvez arriver sur des pages 404, où aucune page n’est trouvée. La plupart du temps il suffit d’enregistrer à nouveau les permaliens (Menu Réglages > Permaliens) pour que tout revienne dans l’ordre.
En cas d’erreur
Contrôler l’URL qui a été remplacée
Directement dans la base de données, il est possible de voir ce que l’on a mis à jour. L’URL principale du site se trouve dans la table d’options. Dans mon cas, elle s’appelle 1404gregoiretheme_options. Par défaut c’est wp_options. Tout dépends du préfixe que vous avez utilisez.
Supprimer toutes les tables de la base
Le mieux est de seulement réinitialiser la base de données en supprimant toutes ses tables. Pour ce faire, il suffit, une fois dans PHPMyAdmin, de sélectionner la base, puis les tables et de choisir Supprimer dans le menu. Une confirmation vous sera demandée. Voici une capture d’écran.
Je vous recommande aussi les nombreux commentaires de cet article qui relate plusieurs expériences et solutions autour de cette opération.
Liens
Pour aller plus loin, quelques liens simples et plus avancés.
Tutoriels
- Requêtes SQL pour changer de nom de domaine un site WordPress. Tutoriel complet qui fait écho mon article. Ce site possède de nombreux articles en français sur SQL.
- Migrating WordPress Websites – Bill Erickson. Voir la partie pour WPEngine
- How to Move WordPress From Local Server to Live Site
- Migrating Your WordPress Database: WP Migrate DB – Development to Production. Même outil avec en prime une vidéo sur la version gratuite.
- Comment migrer son site WordPress avec le script Interconnectit (search and replace tool)
- Comment migrer son site WordPress avec le script DBSR
- Comment migrer sa base de données avec l’extensions WP DB Migrate
- Accéder à la Base de Données d’un site WordPress
Outils et projets en cours
- WordPress Serialized PHP Search Replace Tool. Outil complet d’importation de base, même avec des données sérialisées complexes
- WordPress › migration-portability « Make WordPress Core. Suivi des évolutions du “Core” de WordPress sur wordpress.org. Merci à Manuel
Malgré mes tutoriels, si vous rencontrez des problèmes pour la migration de votre site, je vous recommande très vivement les services de WP Assistance. Je connais bien l’équipe.