Composer/fr

Composer est un gestionnaire de dépendances pour les bibliothèques PHP. À partir de, les dépendances des bibliothèques externes du noyau de MediaWiki sont gérées par Composer. En plus, il peut être utilisé pour gérer l'installation des extensions MediaWiki (disponible depuis ). Néanmoins ceci n'est actuellement pas bien supporté. Cela peut changer à l'avenir.

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

Seul Composer 1.x est supporté par MediaWiki 1.31, 1.35.0 et 1.35.1. Pour récupérer la dernière version stable de Composer 1.x :

Composer 2.x et Composer 1.x sont pris en charge par MediaWiki >= 1.35.2 (conformément à la branche REL1_36 et au Master). Pour récupérer la dernière version stable de Composer 2.x :

Pour les utilisateurs sous macOS, vous pouvez utiliser Homebrew pour installer Composer. Note this will install version Composer 2.x, so depending on the version of MediaWiki you are using, you may need to follow the  instructions above instead to download Composer 1.x. To install using  :

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

Toolforge 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. In these cases, you can just download composer-1.phar in your web browser and then rename it to composer.phar.

Composer 1.x
Pour mettre à jour Composer avec la dernière version stable 1.x (ou pour revenir en arrière à partir d'une 2.x stable), vous pouvez utiliser :

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

Si votre version de Composer est très ancienne, le paramètre  peut être absent. Dans ce cas, exécutez deux fois. La première passe permet de faire la mise à jour vers la version 2.x, et la seconde revient sur la dernière version 1.x.

Composer 2.x
If you are using Composer 1.x, and want to upgrade to Composer 2.x (and are using an appropriate version of MediaWiki, such as >= 1.35.2), you can use:

If the update command fails due to permissions, execute it again with sudo.

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. Afin de permettre aux installations locales d'utiliser Composer pour charger des bibliothèques facultatives et/ou gérer les extensions avec Composer, un plugin spécial pour Composer appelé composer-merge-plugin a été développé. Ce plugin et la configuration  du noyau de MediaWiki permettent à ce qu'un déploiement local puisse ajouter les extensions et les bibliothèques requises à un fichier   dans le répertoire racine de MediaWiki.

peut également être utilisé pour installer les bibliothèques gérées par Composer et qui sont nécessaires aux extensions qui n'ont pas été installées avec Composer. Cela n'est nécessaire que lorsque les extensions ne sont pas installées à partir des archives générées par Extension Distributor.

Pour permettre à Composer de découvrir et de traiter les fichiers  pouvant être inclus dans n’importe laquelle de vos extensions installées localement, ajoutez quelque chose comme ceci à   :

Après toute modification de, vous devez supprimer   avant d'exécuter de nouveau   de sorte que Composer puisse recalculer les dépendances et que les modifications puissent être réalisées.

Ressources

 * Liste des extensions qui peuvent ou doivent être installées avec Composer
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)