Code sur écran d'ordinateur

Installer WordPress et des plugins avec Composer

Installer WordPress avec Composer a longtemps été pénible. Aujourd’hui c’est simple et propre. Voici comment gérer le cœur de WordPress et les plugins entièrement via Composer.

Le cœur de WordPress

Le projet johnpbloch/wordpress suit les dernières versions de WordPress et reste le plus utilisé. Dans le composer.json, on indique le paquet et le dossier d’installation :

{
  "require": {
    "php": ">=8.1",
    "johnpbloch/wordpress": "^6.4"
  },
  "extra": {
    "wordpress-install-dir": "wp"
  }
}

Puis :

composer install

WordPress se retrouve dans le dossier wp.

Installer les plugins au bon endroit

Par défaut, les autres paquets atterrissent dans /vendor. Pour ranger les plugins et thèmes là où WordPress les attend, on s’appuie sur composer/installers, qui reconnaît notamment ces types :

  • wordpress-pluginwp-content/plugins/{$name}/
  • wordpress-themewp-content/themes/{$name}/
  • wordpress-mupluginwp-content/mu-plugins/{$name}/

WordPress Packagist

WordPress Packagist expose l’ensemble des plugins et thèmes du dépôt officiel sous forme de paquets Composer. On ajoute le dépôt, puis les plugins voulus :

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://wpackagist.org"
    }
  ],
  "require": {
    "php": ">=8.1",
    "johnpbloch/wordpress": "^6.4",
    "wpackagist-plugin/advanced-custom-fields": "*"
  },
  "extra": {
    "wordpress-install-dir": "cms",
    "installer-paths": {
      "cms/wp-content/plugins/{$name}": ["type:wordpress-plugin"]
    }
  }
}

Comme WordPress est ici installé dans cms, le bloc installer-paths indique à Composer d’y placer aussi les plugins. Résultat : les plugins arrivent au bon endroit et vous les activez normalement depuis l’administration.

À lire aussi