Pourquoi vous ne pouvez pas vous connecter à WordPress après une migration

Vous venez de terminer la migration de votre site WordPress vers un nouvel hébergeur. Les fichiers ont été transférés, la base de données a été importée et tout devrait fonctionner.

Ensuite, vous essayez de vous connecter à votre tableau de bord d'administration, mais vous n'y parvenez pas.

Peut-être que vous obtenez une boucle de redirection ou une erreur 404. Ou peut-être que vos identifiants ne fonctionnent tout simplement plus, même si vous savez qu'ils sont corrects.

Je suis passé par là. L'impossibilité de se connecter est l'un des problèmes les plus courants rencontrés par les utilisateurs de WordPress après une migration.

Voici ce qui est rassurant dans cette situation : vous n'êtes probablement pas confronté à une panne catastrophique. Dans la plupart des cas, le problème peut être résolu, et vous n'avez pas besoin d'être développeur pour y parvenir.

Dans ce guide, je vais vous présenter toutes les solutions possibles. À la fin, vous serez de retour dans votre tableau de bord, prêt à travailler sur votre site web.

En voici les principaux enseignements :

• Les URL de base de données incorrectes sont à l'origine de la plupart des échecs de connexion après la migration ; corrigez-les dans wp-config.php ou directement dans la base de données.
• Videz le cache du navigateur et le cache au niveau du serveur avant d'essayer toute solution technique.
• Un fichier .htaccess corrompu provenant de votre ancien serveur peut empêcher la connexion ; régénérez-le via Paramètres » Permaliens.
• Les plugins de sécurité et de mise en cache vous bloquent souvent l'accès après la migration ; désactivez les plugins pour tester les conflits.
• Les migrations manuelles sont sujettes à des erreurs ; Duplicator automatise les mises à jour d'URL et élimine les erreurs courantes.

Table des matières

Pourquoi ne pouvez-vous pas vous connecter à l'administration WordPress après une migration ?

Lorsque vous migrez un site WordPress, vous récupérez l'intégralité de votre site web et le transférez vers un environnement complètement différent, avec des chemins d'accès aux fichiers différents et souvent un nouveau nom de domaine.

WordPress stocke de nombreuses informations spécifiques à l'environnement dans sa base de données et ses fichiers de configuration. Lorsque ces informations ne correspondent soudainement plus, des dysfonctionnements apparaissent.

Voici les causes habituelles pour lesquelles votre connexion administrateur ne fonctionne plus.

URL incorrectes dans la base de données

WordPress stocke l'URL de votre site à plusieurs endroits dans la base de données. Si ceux-ci ne correspondent pas à votre nouveau domaine (ou s'ils pointent toujours vers votre ancien domaine), vous verrez généralement apparaître une boucle de redirection ou serez redirigé hors de la page de connexion.

Fichier .htaccess corrompu ou incompatible

Le fichier .htaccess contrôle la manière dont votre serveur gère les URL et les redirections. Le fichier provenant de votre ancien serveur peut ne pas être compatible avec votre nouveau serveur, en particulier si vous êtes passé d'Apache à Nginx, ou vice versa.

Conflits de plugins ou de thèmes

Certains plugins (en particulier les plugins de sécurité et de mise en cache) stockent des paramètres spécifiques au serveur. Après une migration, ils pourraient vous bloquer l'accès ou provoquer des erreurs fatales avant même que vous ne voyiez l'écran de connexion.

Autorisations de fichier incorrectes

Votre nouveau serveur peut avoir des exigences différentes en matière d'autorisations. Si WordPress ne peut pas lire ou écrire les fichiers dont il a besoin, vous rencontrerez des problèmes de connexion.

Fichiers principaux corrompus

Il arrive parfois que des fichiers soient corrompus pendant le processus de transfert. Si des fichiers WordPress essentiels n'ont pas été transférés correctement, le système de connexion ne fonctionnera tout simplement pas.

Comment résoudre les problèmes de connexion après une migration

Appliquez ces corrections dans l'ordre. Commencez par les plus simples : inutile de fouiller dans la base de données si le simple fait de vider votre cache résout le problème.

Voici comment résoudre les problèmes de connexion à WordPress après une migration :

• Corrections générales de connexion à l'administration : effacer les caches du navigateur et du serveur, vérifier manuellement les identifiants et tester les e-mails de réinitialisation du mot de passe.
• Corrigez les URL incorrectes dans wp-config.php: remplacez les valeurs de la base de données en ajoutant les définitions WP_HOME et WP_SITEURL.
• Mettez à jour les URL directement dans la base de données: modifiez les valeurs siteurl et home dans la table wp_options à l'aide de phpMyAdmin.
• Réinitialisez votre fichier .htaccess: renommez l'ancien fichier et régénérez-en un nouveau via Paramètres » Permaliens.
• Vérifiez s'il y a des conflits entre les plugins: renommez le dossier plugins pour désactiver tous les plugins et testez votre connexion.
• Réinitialisez manuellement votre mot de passe administrateur: mettez à jour le champ user_pass dans la table wp_users.
• Remplacer les fichiers WordPress principaux: télécharger les nouveaux dossiers wp-admin et wp-includes et les transférer via FTP.
• Vérifiez les permissions des fichiers: définissez les dossiers sur 755 et les fichiers sur 644 sur votre nouveau serveur.
• Vérifier les métadonnées utilisateur: s'assurer que wp_capabilities dans wp_usermeta contient le rôle d'administrateur approprié.
• Activer le débogage: ajoutez des lignes WP_DEBUG au fichier wp-config.php pour identifier des messages d'erreur spécifiques.

Corrections relatives à la connexion à l'administration générale

Avant d'entrer dans les détails techniques, éliminons les éléments simples.

Videz d'abord le cache et les cookies de votre navigateur. Ensuite, et c'est la partie que les gens oublient, vérifiez si votre hébergeur dispose d'une mise en cache au niveau du serveur.

Les hébergeurs tels que Kinsta, WP Engine et SiteGround disposent tous de leurs propres systèmes de mise en cache. Connectez-vous à votre panneau de contrôle d'hébergement et purgez également le cache à cet endroit.

Vérifiez ensuite vos identifiants de connexion. Je sais que vous avez déjà essayé, mais faites-moi plaisir.

Saisissez votre mot de passe manuellement au lieu d'utiliser la fonction de remplissage automatique. La fonction de remplissage automatique peut parfois remplir d'anciennes informations d'identification, en particulier si vous avez récemment changé de domaine.

Même si vous êtes sûr de votre mot de passe, cliquez sur le lien « Mot de passe perdu ? » et vérifiez si vous recevez l'e-mail de réinitialisation.

Si vous ne recevez pas l'e-mail, cela vous indique quelque chose d'utile : WordPress ne peut pas envoyer d'e-mails depuis votre nouveau serveur. (Il s'agit d'un problème distinct, mais au moins vous saurez à quoi vous en tenir.)

Toujours bloqué ? Il est temps d'approfondir la question.

Corriger les URL incorrectes

Les URL incorrectes sont à l'origine de la plupart des problèmes de connexion après la migration.

WordPress stocke l'URL de votre site dans la base de données dans deux champs appelés siteurl et home.

Si ceux-ci pointent toujours vers votre ancien domaine, WordPress tentera de vous rediriger vers celui-ci chaque fois que vous essaierez de vous connecter. Vous vous retrouverez alors dans une boucle de redirection, rebondissant entre l'ancienne URL et la nouvelle jusqu'à ce que votre navigateur abandonne.

Vous avez deux façons de résoudre ce problème.

Méthode 1 : corriger les URL incorrectes dans wp-config.php

Le moyen le plus rapide pour revenir à votre tableau de bord est de mettre à jour votre fichier wp-config.php.

Connectez-vous à votre site via FTP ou le gestionnaire de fichiers de votre hébergeur. Ouvrez le fichier wp-config.php dans le répertoire racine de votre site.

Ajoutez ces deux lignes près du haut, juste après l'ouverture <?php balise :

define( 'WP_HOME', 'https://your-new-domain.com' );

define( 'WP_SITEURL', 'https://your-new-domain.com' );

Remplacez votre-nouveau-domaine.com par votre domaine réel. Assurez-vous d'utiliser le protocole HTTPS si vous disposez d'un certificat SSL (ce qui devrait être le cas).

Enregistrez le fichier et essayez de vous reconnecter.

Cela remplace tout ce qui se trouve dans la base de données. Mais voilà le problème : ce n'est qu'un palliatif. Les URL incorrectes sont toujours présentes dans votre base de données. Pour une solution permanente, vous devez mettre à jour la base de données elle-même.

Méthode 2 : corriger les URL incorrectes dans la base de données

Connectez-vous à phpMyAdmin (vous le trouverez dans votre panneau de contrôle d'hébergement — cPanel, Plesk ou tout autre logiciel utilisé par votre hébergeur). Sélectionnez votre base de données WordPress dans la barre latérale gauche.

Trouvez le wp_options table et cliquez dessus. (Si votre base de données utilise un préfixe différent, il peut s'agir d'un nom tel que wp_abc123_options.)

Recherchez deux lignes :

• siteurl
• maison

Cliquez sur Editer sur chacun d'eux et mettre à jour le option_value champ vers votre nouveau domaine. Encore une fois, assurez-vous d'utiliser le protocole correct : https ou http.

Enregistrez vos modifications. Essayez maintenant de vous connecter.

Si vous avez ajouté ces lignes au fichier wp-config.php précédemment, vous pouvez les supprimer maintenant. La base de données contient les valeurs correctes.

Réinitialisez votre fichier .htaccess

Le fichier .htaccess contrôle la réécriture des URL et les redirections sur les serveurs Apache. Si vous avez migré vers un nouveau serveur (en particulier si la configuration du serveur est différente), votre ancien fichier .htaccess peut causer des problèmes.

La solution est simple : en générer un nouveau.

Connectez-vous via FTP ou le gestionnaire de fichiers. Recherchez le fichier .htaccess dans votre répertoire racine. (Si vous ne le voyez pas, assurez-vous que les fichiers cachés sont visibles dans votre client FTP.)

Renommez-le en quelque chose comme .htaccess_old. Cela le désactive sans le supprimer.

Essayez de vous connecter maintenant. Si cela fonctionne, vous avez confirmé que le fichier .htaccess était à l'origine du problème.

Pour générer un nouveau fichier, connectez-vous à votre tableau de bord WordPress et allez dans Paramètres » Permaliens. Ne modifiez rien, faites simplement défiler vers le bas et cliquez sur Enregistrer les modifications.

WordPress créera un nouveau fichier .htaccess contenant les règles adaptées à votre nouveau serveur.

Vérifiez les conflits entre les plugins et les thèmes

Les plugins de sécurité adorent verrouiller les choses. Les plugins de mise en cache adorent servir des pages obsolètes. L'un ou l'autre peut vous empêcher de vous connecter après une migration.

Voici comment tester les conflits.

Connectez-vous via FTP et accédez à wp-content. Renommez le dossier plugins en plugins_old, par exemple.

Essayez de vous connecter. Si cela fonctionne, vous savez qu'un conflit entre plugins était à l'origine du problème.

Réactivez maintenant les plugins un par un. Testez votre connexion après chaque réactivation jusqu'à ce que vous trouviez le coupable.

Vous pouvez faire la même chose avec votre thème actif. Renommez le dossier du thème dans wp-content/themes. WordPress reviendra alors au thème par défaut, ce qui devrait vous permettre de vous connecter si le problème venait de votre thème.

Réinitialisez manuellement votre mot de passe administrateur

Peut-être que votre mot de passe a vraiment été brouillé pendant la migration. Cela arrive, surtout s'il y a eu des problèmes d'encodage des caractères pendant le transfert de la base de données.

Vous pouvez le réinitialiser directement dans la base de données.

Connectez-vous à phpMyAdmin et sélectionnez votre base de données WordPress. Ouvrez le fichier wp_users table.

Recherchez la ligne correspondant à votre utilisateur administrateur (généralement celle dont l'ID est 1). Cliquez sur Modifier.

Dans le user_pass champ, entrez votre nouveau mot de passe. Dans le champ Fonction menu déroulant à côté du champ mot de passe, sélectionnez MD5. Cela indique à la base de données de hacher correctement votre mot de passe.

Enregistrez les modifications et essayez de vous connecter avec votre nouveau mot de passe.

Remplacer les fichiers WordPress principaux

Vous êtes peut-être confronté à des fichiers WordPress endommagés. La solution consiste à les remplacer par des copies neuves.

Rendez-vous sur wordpress.org et téléchargez la dernière version de WordPress (ou la même version que celle que vous utilisez actuellement). Extrayez le fichier ZIP sur votre ordinateur.

Connectez-vous via FTP. Accédez au répertoire racine de votre site.

Supprimez les dossiers wp-admin et wp-includes de votre serveur. Téléchargez les nouvelles versions à partir du téléchargement WordPress que vous venez d'extraire.

Ne touchez pas au dossier wp-content. C'est là que se trouvent tous vos plugins, thèmes et fichiers téléchargés. Vous ne remplacez que les fichiers système principaux.

Essayez de vous reconnecter.

Vérifier les autorisations de fichiers

Votre nouveau serveur peut nécessiter des autorisations d'accès aux fichiers différentes de celles de l'ancien.

Les autorisations standard sont les suivantes :

• Dossiers : 755
• Fichiers : 644

Vous pouvez les modifier via votre client FTP (la plupart disposent d'une option « Autorisations de fichiers » ou « CHMOD » lorsque vous cliquez avec le bouton droit sur un fichier/dossier) ou via le gestionnaire de fichiers de votre hébergeur.

Vérifier les métadonnées utilisateur

Celui-ci est plus obscur, mais je l'ai déjà vu se produire. Parfois, les données relatives aux rôles des utilisateurs sont brouillées lors de la migration.

Connectez-vous à phpMyAdmin et ouvrez le fichier wp_usermeta table.

Trouvez la ligne où meta_key est wp_capabilities et user_id correspond à votre identifiant utilisateur administrateur (généralement 1).

Vérifier le meta_value champ. Il doit contenir :

a:1:{s:13:"administrator";b:1;}

Si elle est vide ou contient autre chose, modifiez-la pour qu'elle corresponde au texte ci-dessus.

Activer le débogage

Si aucune des solutions ci-dessus n'a fonctionné, il est temps de voir ce qui pose réellement problème à WordPress.

Ouvrez wp-config.php via FTP. Ajoutez ces lignes :

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

define( 'WP_DEBUG_DISPLAY', false );

Cela permet le débogage sans afficher d'erreurs sur votre site (ce qui constituerait un risque pour la sécurité).

Essayez de vous reconnecter. WordPress enregistrera désormais toutes les erreurs dans un fichier appelé debug.log situé dans le répertoire wp-content.

Téléchargez ce fichier et lisez-le. Les messages d'erreur vous indiqueront généralement directement le problème : un plugin spécifique, un problème de connexion à la base de données ou un fichier manquant.

Une fois que vous avez identifié et corrigé le problème, revenez en arrière et supprimez ces lignes de débogage du fichier wp-config.php. Il n'est pas souhaitable de laisser le mode débogage activé sur un site en ligne.

Comment éviter les problèmes de connexion à l'administration WordPress lors d'une migration

Vous avez donc résolu le problème. Vous êtes de retour dans votre tableau de bord. Tout fonctionne à nouveau.

Mais soyons honnêtes, cela a probablement pris plus de temps que prévu.

La plupart de ces problèmes de connexion sont dus à de petites erreurs manuelles. Une faute de frappe dans la base de données. Oublier de mettre à jour les URL. Transférer un fichier qui n'a pas été transféré correctement.

Lorsque vous faites tout à la main, ces erreurs sont presque inévitables. Vous jonglez entre les exportations de bases de données, les téléchargements FTP et les opérations de recherche et remplacement dans phpMyAdmin : il existe une douzaine d'endroits où un seul caractère erroné peut vous bloquer l'accès.

C'est pourquoi j'ai arrêté les migrations manuelles il y a des années.

Duplicator gère automatiquement toutes les parties sujettes aux erreurs. Il est spécialement conçu pour éviter les problèmes de migration.

Le programme d'installation de Duplicator effectue une recherche et un remplacement complets dans l'ensemble de votre base de données. Toutes les anciennes URL sont mises à jour vers les nouvelles, pas seulement les champs siteurl et home, mais partout.

Duplicator génère un nouveau fichier wp-config.php basé sur les identifiants de connexion à la base de données que vous fournissez lors de l'installation. Il crée également un nouveau fichier .htaccess optimisé pour votre nouvel environnement serveur.

Lorsque vous utilisez un outil de migration dédié, vous ne dépendez pas de votre mémoire ou d'une liste de contrôle. Duplicator effectue une migration parfaite à chaque fois, dans le même ordre, sans sauter d'étapes. Cette cohérence élimine les erreurs humaines qui provoquent des blocages.

Je ne dis pas que les migrations manuelles sont impossibles. Mais elles exigent de la concentration, une attention particulière aux détails et des compétences. Si vous manquez une étape, vous passerez des heures à résoudre des problèmes.

Duplicator élimine cette incertitude. Vous créez une sauvegarde, vous la téléchargez sur votre nouvel hébergeur, vous lancez le programme d'installation, et le tour est joué.

La connexion fonctionne car toutes les URL sont correctes, la configuration est propre et rien n'a été corrompu pendant le transfert.

Si vous migrez régulièrement des sites (ou si vous souhaitez simplement éviter d'être à nouveau bloqué), il est utile d'utiliser un outil spécialement conçu pour cette tâche.

Foire aux questions (FAQ)

Connectez-vous à WordPress immédiatement après une migration

Même lorsque vous savez ce que vous faites lors d'une migration manuelle, celle-ci reste stressante.

Vous déplacez des dizaines de fichiers, exportez des bases de données, effectuez des opérations de recherche et de remplacement, mettez à jour des fichiers de configuration, tout en espérant n'avoir rien oublié. Puis vous retenez votre souffle pendant que vous essayez de vous connecter, car si quelque chose s'est mal passé, vous risquez de passer une heure à dépanner le système.

C'est du temps que vous ne récupérerez jamais.

Duplicator Pro a été spécialement conçu pour éliminer ce stress. Il automatise les étapes qui posent problème (remplacement d'URL, mises à jour de configuration, transferts de fichiers) afin que vous puissiez migrer en toute confiance.

Vous effectuerez des migrations fiables et reproductibles qui fonctionneront dès la première fois.

Si vous en avez assez des dépannages, essayez Duplicator Pro. C'est la différence entre passer votre après-midi à réparer une migration et passer cinq minutes à exécuter un programme d'installation.

Pendant que vous êtes ici, je pense que vous aimerez ces autres ressources WordPress :

• Comment réparer un site WordPress lent après une migration
• Votre site WordPress pourrait disparaître demain (à moins que vous ne fassiez ceci)
• La médiathèque de WordPress n'affiche pas les images ? Réparez-la en moins de 15 minutes
• Que faire lorsque vous êtes bloqué hors de WordPress ?
• WordPress bloqué en mode maintenance ? Voici comment relancer votre site
• La liste de contrôle pré-migration qui permet d'éviter les désastres liés à la migration des sites web