22.6 Modifier l'URL d'un site WordPress sans briser la sérialisation

Pendant la phase de développement d'un site WordPress sur une machine locale, l'URL est différent de celui qui sera utilisé lorsque le site sera en production. Un ajustement sera requis lors de la mise en ligne.

Le problème, c'est que WordPress enregistre l'URL absolu de chaque image dans la base de données. Il faudra donc modifier la base de données afin d'y ajuster tous les URL.

Dans tous les cas, il serait fastidieux d'apporter les modifications manuellement à l'aide d'un outil de gestion de bases de données comme phpMyAdmin.

Après vous avoir démontré les modifications à apporter, je vais vous proposer des outils qui permettent de rendre le processus plus digeste.

URL dans un article ou dans une page

Si vous ajoutez l'image monchien.png à un article sur votre site local, vous devrez retrouver l'enregistrement de la base de données qui correspond à l'article et changer ceci :

pour ceci :

URL dans une personnalisation

Si une image a été utilisée dans les personnalisations du thème traditionnel, le fait de modifier l'URL du site pourrait affecter plusieurs autres personnalisations.

Notez que ce problème est inexistant avec les thèmes basés sur des blocs.

C'est que sur un thème traditionnel, les personnalisations sont enregistrées dans la table wp_options après avoir été sérialisées. Le fait de modifier la longueur de l'URL brouillera les valeurs sérialisées alors WordPress ne pourra pas retrouver ces valeurs.

Consultez la fiche « Pourquoi est-ce que je perds les personnalisations de mon thème lors de la mise en ligne ? » pour voir une démonstration des erreurs de sérialisation causées par un changement d'URL.

Extension pour modifier l'URL

Plutôt que de modifier à la main les URL dans la base de données, il est possible d'utiliser une extension qui se chargera de :

• modifier les URL
• ajuster les valeurs sérialisées

Parmi les extensions qui offrent cette fonctionnalité, notons :

• Better Search Replace : https://wordpress.org/plugins/better-search-replace/
• Search & Replace : https://wordpress.org/plugins/search-and-replace/
• Better Find and Replace : https://fr-ca.wordpress.org/plugins/real-time-auto-find-and-replace/
• Go Live Update Urls : https://wordpress.org/plugins/go-live-update-urls/

Principes généraux pour utiliser une de ces extensions

Pour assurer que votre site fonctionne bien en local et en ligne, suivez ces étapes.

Notez que certaines extensions pourraient fournir des étapes différentes, à vous de choisir l'approche qui vous plaît.

• Générez un script SQL de votre base de données locale. Ceci vous permettra de remettre la base de données en place pour faire fonctionner votre site local après la manipulation. Donnez un nom clair au script, par exemple site-local-aaaa-mm-jj.sql.
• Installez l'extension désirée et activez-la.
• La plupart des extensions ajoutent une option dans le menu Outils du tableau de bord. Rendez-vous dans l'option de menu ajoutée par votre extension.
• Dans le formulaire prévu à cette fin, entrez l'URL du site en développement comme valeur recherchée et l'URL du site en ligne comme valeur de remplacement.
• Une fois le remplacement effectué, votre site local ne fonctionnera probablement plus. Ceci sera réglé dans une étape plus loin.
• Générez un nouveau script SQL de votre base de données. C'est ce script qui sera installé sur le serveur de production. Donnez un nom clair au script, par exemple site-en-production-aaaa-mm-jj.sql.
• Afin de rendre votre site local fonctionnel à nouveau, supprimez toutes les tables de la base de données que vous venez d'ajuster puis recréez-les à l'aide du script SQL que vous avez généré au tout début de l'opération.