Composer/fr

Composer est un gestionnaire de dépendances pour les bibliothèques PHP. En plus, il peut être utilisé pour gérer l'installation des extensions MediaWiki (depuis ). À partir de, les dépendances des bibliothèques externes du noyau de MediaWiki sont gérées par Composer.

Sous Unix/Linux et macOS
Il existe plusieurs manières d'accéder à install Composer, à côté de la plus évidente, :

Pour récupérer la dernière version :

Ceci télécharge l'image du master actuel et expirera dans 30 jours. Il existe aussi des archives PHP (phars) pour les « versions » alpha comme 1.0.0-alpha.

Pour les utilisateurs sous OS X, vous pouvez utiliser Homebrew pour installer Composer :

Si cela ne fonctionne pas, ou que vous n'avez pas installé Homebrew, vous pouvez essayer :

Jenkins et le distributeur d'extensions utilisent la copie de composer contenue dans le répertoire Git « integration/composer ».

Une fois composer installé, vous pouvez exécuter les commandes via le fichier phar téléchargé :

Vous pouvez déplacer le fichier phar dans votre chemin de sorte qu'il soit utilisé comme un exécutable classique :

Si la commande mv échoue à cause des droits d'accès, exécutez-la de nouveau avec sudo.

Sous Windows
Téléchargez simplement et exécutez l'installeur à partir de la page de téléchargement. Si vous préférez une installation manuelle, vous pouvez suivre les étapes précédentes sauf que Windows ne dispose pas de wget (ni d'APT i de Homebrew) par défaut, et qu'il n'existe pas de répertoire /usr/local/bin.

Utilisation dans le noyau MediaWiki
MediaWiki 1.25+ dépend de quelques bibliothèques externes gérées par Composer. Composer crée un chargeur automatique sur, qui est inclus par.

Les dépendances gérées par Composer sont regroupées dans des distributions tarball de MediaWiki et des extensions afin que les administrateurs système n'aient pas besoin d'utiliser directement Composer. Lorsque vous installez MediaWiki avec Git, les dépendances déclarées dans  peuvent soit être installées localement en exécutant   ou le référentiel   peut être cloné pour fournir les mêmes bibliothèques que celles utilisées sur la grappe de production Wikimedia.

Utilisation du plugin composer-merge
Le noyau de MediaWiki « est propriétaire de »  et modifiera le contenu de ce fichier dans les mises à jour par tarball ou gérées par Git. In order to allow local installs to use Composer to load optional libraries and/or manage extensions with Composer, a special plugin for Composer named composer-merge-plugin was developed. This plugin and the MediaWiki core  configuration allow a local deployment to add required extensions and libraries to a file   inside the root MediaWiki directory.

can also be used to install Composer managed libraries that are needed by extensions that are not installed using Composer themselves. This is only needed when the extensions are not installed from tarballs generated by Extension Distributor.

To enable Composer to discover and process the  files that may be included in any and all of your locally installed extensions, add something like this to  :

Ressources

 * - doit être utilisé pour MediaWiki ≤ 1.21.x pour installer les extensions par Composer
 * List of extensions that can or must be installed with Composer
 * List of extensions that can or must be installed with Composer