Vous pouvez désormais définir des racines web (webroots) personnalisées pour vos sites WordPress sur Kinsta en utilisant notre API publique. Cela donne aux développeurs et aux agences une plus grande flexibilité dans la gestion des déploiements, du contrôle des versions ou des structures de site personnalisées, sans avoir à contacter le support.

Auparavant, si vous vouliez changer le webroot d’un site (par exemple, pour soutenir des structures comme Bedrock, où le dossier public est /public/web), vous deviez ouvrir un ticket de support. Désormais, vous pouvez le faire de manière programmatique, ce qui fait gagner du temps aux équipes qui gèrent plusieurs environnements ou des flux de travail complexes.

Comment changer le webroot de votre site WordPress ?

Pour changer le webroot d’un site, envoyez une requête POST au point de terminaison de l’API Kinsta /change-webroot-subfolder de l’API Kinsta pour un environnement spécifique.

Voici un exemple de requête POST:

curl -i -X POST 
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-webroot-subfolder' 
  -H 'Authorization: Bearer ' 
  -H 'Content-Type: application/json' 
  -d '{
    "web_root_subfolder": "your_subfolder_name",
    "clear_all_cache": true,
    "refresh_plugins_and_themes": true
  }'

Dans cette requête :

  • env_id est l’ID de l’environnement WordPress que vous souhaitez mettre à jour.
  • web_root_subfolder définit le nouveau sous-dossier que vous souhaitez utiliser comme racine du site (par exemple, release_v2 ou web).
  • clear_all_cache (facultatif) détermine si le cache du site doit être effacé pendant la modification. La valeur par défaut est true.
  • refresh_plugins_and_themes (facultatif) actualise les fichiers d’extensions et de thèmes pour éviter les conflits après le changement. La valeur par défaut est true.

Une fois que vous avez envoyé la demande, Kinsta met à jour la configuration du serveur pour pointer vers le nouveau sous-dossier. De plus, il peut vider le cache et rafraîchir les fichiers d’extensions et de thèmes si vous avez activé ces options.

Une fois le processus terminé, le chemin du webroot mis à jour apparaît dans les détails de votre environnement MyKinsta, comme indiqué ci-dessous.

Le chemin du webroot mis à jour est affiché dans les détails de l'environnement.
Le chemin du webroot mis à jour est affiché dans les détails de l’environnement.

Une gestion de WordPress qui s’adapte à votre flux de travail

Avec l’API Kinsta, vous pouvez faire plus que définir un webroot personnalisé. Automatisez les mises à jour sur plusieurs sites, intégrez les changements de webroot dans votre processus de déploiement, ou même créez des outils comme Slackbots pour gérer vos environnements à la volée.

Il s’agit de vous donner plus de contrôle – et de faciliter le fonctionnement des sites WordPress comme vous le souhaitez.

Vous n’êtes pas encore client de Kinsta ? Consultez nos plans d’hébergement pour voir ce qu’il est possible de faire.