Composer est un outil de gestion des dépendances pour PHP, utilisé pour gérer les bibliothèques requises par un projet et leurs versions.

Composer définit les dépendances via le fichier composer.json et gère automatiquement l'installation et les mises à jour.

Par défaut, Composer n'est pas installé globalement, mais est installé dans un répertoire spécifique du projet donné (par exemple, vendor).

Composer nécessite PHP 5.3.2+ ou version ultérieure, et openssl doit être activé.

Composer peut fonctionner sur les plateformes Windows, Linux et OSX.

Fonctionnalités principales

  1. Gestion des dépendances: installer et gérer automatiquement les bibliothèques requises par le projet.

  2. Chargement automatique: générer des fichiers de chargement automatique pour simplifier le chargement des classes.

  3. Contrôle de version: prend en charge le versionnage sémantique pour garantir la compatibilité des bibliothèques dépendantes.

  4. Prise en charge des scripts: permet d'exécuter des scripts personnalisés sur des événements spécifiques (tels que l'installation ou la mise à jour).

Composer génère le fichier vendor/autoload.php. Il suffit de l'inclure dans le projet pour charger automatiquement les classes :

require 'vendor/autoload.php';

Installation de Composer

Plateforme Windows

Sous Windows, il suffit de téléchargerComposer-Setup.exepuis de l’installer étape par étape.

Notez que vous devez activer la configuration openssl. Ouvrez php.ini dans le répertoire php, etextension=php_openssl.dllSupprimez simplement le point-virgule qui le précède.

Après une installation réussie, nous pouvons saisir la commande suivante dans l’invite de commandes (cmd) :composer --versionpour vérifier si l’installation a réussi :

Ensuite, nous pouvons basculer vers le miroir complet Composer d’Alibaba Cloud :

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

Annuler la configuration :

composer config -g --unset repos.packagist

Configuration du projet

Modifie uniquement la configuration du projet actuel ; seul le projet actuel peut utiliser cette adresse de miroir :

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

Annuler la configuration :

composer config --unset repos.packagist

Débogage

L’ajout de -vvv à la commande composer affiche des informations détaillées. La commande est la suivante :

composer -vvv require alibabacloud/sdk

Vous rencontrez des problèmes ?

1. Il est recommandé de d’abord mettre à niveau la version de Composer vers la dernière :

composer self-update

2. Exécutez la commande de diagnostic :

composer diagnose

3. Videz le cache :

composer clear

4. Si le projet a été précédemment installé à partir d'autres sources, vous devez mettre à jour le fichier composer.lock en exécutant la commande :

composer update --lock

5. Réessayez une fois

Plateforme Linux

Sur Linux, vous pouvez utiliser les commandes suivantes pour installer :

# php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
# php composer-setup.php

All settings correct for using Composer
Downloading...

Composer (version 1.6.5) successfully installed to: /root/composer.phar
Use it: php composer.phar

Déplacez composer.phar afin que composer puisse être appelé globalement :

# mv composer.phar /usr/local/bin/composer

Basculez vers un miroir domestique :

# composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

Mettez à jour composer :

# composer selfupdate

Système Mac OS

Sur Mac OS, vous pouvez utiliser les commandes suivantes pour installer :

$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
$ composer --version
Composer version 1.7.2 2018-08-16 16:57:12

Basculez vers un miroir domestique :

$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

Mettez à jour composer :

$ composer selfupdate

Utilisation de Composer

Pour utiliser Composer, nous devons d'abord créer un fichier composer.json dans le répertoire du projet. Le fichier décrit les dépendances du projet.

Le format du fichier est le suivant :

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

Le fichier ci-dessus indique que nous devons télécharger n'importe quelle version de monolog à partir de 1.2.

Ensuite, il suffit d'exécuter la commande suivante pour installer les paquets de dépendances :

composer install

commande require

En plus d'utiliser la commande install, nous pouvons également utiliser la commande require pour installer rapidement une dépendance sans ajouter manuellement les informations de dépendance à composer.json :

$ composer require monolog/monolog

Composer va d'abord trouver une version appropriée, puis mettre à jour le fichier composer.json, ajouter les informations pertinentes du paquet monolog/monolog sous require, télécharger et installer les dépendances associées, et enfin mettre à jour le fichier composer.lock et générer le fichier d'autoload PHP.

commande update

La commande update est utilisée pour mettre à jour tous les paquets du projet, ou des paquets spécifiques :

# 更新所有依赖
$ composer update

# 更新指定的包
$ composer update monolog/monolog

# 更新指定的多个包
$ composer update monolog/monolog symfony/dependency-injection

# 还可以通过通配符匹配包
$ composer update monolog/monolog symfony/*

Notez que les versions vers lesquelles un paquet peut être mis à niveau sont contraintes par les contraintes de version ; le paquet ne sera pas mis à niveau au-delà de la plage autorisée par les contraintes. Par exemple, si la contrainte de version d'un paquet dans composer.json est ^1.10, et que la dernière version est 2.0, alors la commande update ne peut pas mettre le paquet à niveau vers 2.0 ; elle ne peut le mettre à niveau que jusqu'à une version 1.x. Pour les contraintes de version, voir l'introduction plus loin.

commande remove

La commande remove est utilisée pour supprimer un paquet et ses dépendances (à condition que les dépendances ne soient pas utilisées par d'autres paquets). Si une dépendance est utilisée par un autre paquet, elle ne peut pas être supprimée :

$ composer remove monolog/monolog
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 0 installs, 0 updates, 2 removals
  - Removing psr/log (1.0.2)
  - Removing monolog/monolog (1.23.0)
Generating autoload files

commande search

La commande search permet de rechercher des paquets :

$ composer search monolog

Cette commande affiche le paquet et sa description. Si vous souhaitez uniquement afficher le nom du paquet, vous pouvez utiliser le paramètre--only-name:

$ composer search --only-name monolog

commande show

La commande show peut lister des informations sur les paquets utilisés par le projet actuel :

# 列出所有已经安装的包
$ composer show

# 可以通过通配符进行筛选
$ composer show monolog/*

# 显示具体某个包的信息
$ composer show monolog/monolog

Contraintes de base

Version exacte

Nous pouvons indiquer à Composer la version exacte à installer, par exemple : 1.0.2, en spécifiant la version 1.0.2.

Range

Utilisez des opérateurs de comparaison pour spécifier la plage d’un paquet. Ces opérateurs incluent :>,>=,<,<=,!=。

Vous pouvez définir plusieurs plages. Utilisez des espaces ou des virgules , pour le ET logique, et des doubles barres verticales || pour le OU logique. La priorité de ET est supérieure à celle de OU. Exemple :

  • >=1.0
  • >=1.0 <2.0
  • >=1.0 <1.1 || >=1.2

Nous pouvons également utiliser un trait d’union-pour spécifier une plage de versions.

Le côté gauche du trait d’union indique>=la version. Si la version à droite n’est pas un numéro de version complet, elle sera complétée à l’aide de jokers. Par exemple1.0 - 2.0est équivalent à>=1.0.0 <2.1(2.0est équivalent à2.0.*), et1.0.0 - 2.1.0est équivalent à>=1.0.0 <=2.1.0。

Joker

Vous pouvez utiliser des jokers pour définir des versions.1.0.*est équivalent à>=1.0 <1.1。
Exemple :1.0.*

Tilde ~

Commençons par expliquer l'utilisation de l'opérateur ~ à travers l'exemple suivant :~1.2est équivalent à>=1.2 <2.0.0, et~1.2.3est équivalent à>=1.2.3 <1.3.0. Pour les projets utilisantSemantic Versioningcomme standard de versionnage, cette méthode de contrainte de version est très pratique. Par exemple~1.2définit la version mineure minimale, et vous pouvez mettre à niveau vers n'importe quelle version inférieure à 2.0 sans problème, car selonSemantic Versioningla définition de version, les mises à niveau de version mineure ne devraient pas avoir de problèmes de compatibilité. En termes simples,~définit la version minimale et permet de mettre à niveau le dernier chiffre du numéro de version (si vous n'avez pas compris, veuillez regarder à nouveau les exemples précédents).
Exemple :~1.2

Notez que si ~ agit sur le numéro de version majeure, par exemple~1, selon ce qui précède, Composer pourrait installer des versions majeures après la version 1, mais en fait~1est traité comme~1.0, donc seules les versions mineures peuvent être augmentées, pas la version majeure.

Caret ^

^Le comportement de l'opérateur est étroitement lié àSemantic Versioning. Il permet de mettre à niveau des versions vers des versions sûres. Par exemple,^1.2.3est équivalent à>=1.2.3 <2.0.0, car les versions antérieures à 2.0 ne devraient pas avoir de problèmes de compatibilité. Pour les versions antérieures à 1.0, cette contrainte tient également compte de la sécurité, par exemple^0.3est traité comme>=0.3.0 <0.4.0.
Exemple :^1.2.3


Stabilité des versions

Si vous ne spécifiez pas explicitement la stabilité d'une version, Composer utilisera par défaut en interne-devou-stable. Par exemple :

Contrainte Contrainte interne
1.2.3 =1.2.3.0-stable
>1.2 >1.2.0.0-stable
>=1.2 >=1.2.0.0-dev
>=1.2-stable >=1.2.0.0-stable
<1.3 <1.3.0.0-dev
<=1.3 <=1.3.0.0-stable
1 - 2 >=1.0.0.0-dev <3.0.0.0-dev
~1.3 >=1.3.0.0-dev <2.0.0.0-dev
1.4.* >=1.4.0.0-dev <1.5.0.0-dev
Exemple :1.0 - 2.0Si vous voulez spécifier que seules les versions stables sont acceptées, vous pouvez ajouter un suffixe après la version-stable。

minimum-stabilityL'élément de configuration définit le comportement par défaut pour la sélection de stabilité lorsqu'un paquet choisit une version. La valeur par défaut eststable. Ses valeurs sont les suivantes (triées par stabilité) :dev,alpha,beta,RCetstableEn plus de modifier cette configuration pour changer le comportement par défaut, nous pouvons égalementindicateur de stabilité(par exemple@stableet@dev) pour installer une version dont la stabilité diffère de la configuration par défaut. Par exemple :

{
    "require": {
        "monolog/monolog": "1.0.*@beta",
        "acme/foo": "@dev"
    }
}