1 Introduction
Composer est un outil de gestion des dépendances pour PHP. Il vous permet de déclarer les bibliothèques de code dont dépend votre projet et il les installera pour vous dans votre projet.
2. Configuration système requise
PHP 5.3.2+ ou supérieur est requis pour exécuter Composer.
Composer est multiplateforme, il peut fonctionner simultanément sur les plateformes Windows, Linux et OSX.
3. Installer (ubuntu)
curl -sS https://getcomposer.org/installer | php mv composer.phar mv composer.phar /usr/local/bin/composer
Remarque : si curl n'est pas installé, vous pouvez l'installer via la commande suivante
apt-get update apt-get install curl
Une fois votre Composer installé, vous pouvez utiliser la commande suivante pour vérifier si l'installation a réussi
composer -v
Remarque Si la méthode ci-dessus échoue pour une raison quelconque, vous pouvez également télécharger le programme d'installation via php :
php -r "readfile('https://getcomposer.org/installer');" | php
Cela vérifiera certains paramètres PHP, puis téléchargera composer.phar
dans votre répertoire de travail. . Il s'agit du binaire Composer. Il s'agit d'un package PHAR (PHP Archive), qui est un format d'archive PHP qui aide les utilisateurs à effectuer certaines opérations sur la ligne de commande. omposer.phar
到你的工作目录中。这是 Composer 的二进制文件。这是一个 PHAR 包(PHP 的归档),这是 PHP 的归档格式可以帮助用户在命令行中执行一些操作。
你可以通过 --install-dir
选项指定 Composer 的安装目录(它可以是一个绝对或相对路径)
4.使用
要开始在你的项目中使用 Composer,你只需要一个 composer.json
文件。该文件包含了项目的依赖和其它的一些元数据。
首先创建一个 composer.json
文件,写入相应的包名和版本号,如
{ "require": { "monolog/monolog": "1.13.*" } }
这是后就写入了一个依赖包,之后安装依赖包。获取定义的依赖到你的本地项目,之后在你的项目目录中(即 composer.json
所在目录)使用 Composer 运行 install
命令。
composer install
当然,如果是在 Windows
系统中,也可以通过调用 composer.phar
包来进行依赖包的安装。
php composer.phar install
执行 composer install
,就进入自动安装,安装完成后会生成一个 composer.lock
文件,里面是特定的版本号名,需要这个文件和 composer.json
一起提交到版本管理里去。
最后,在需要更新依赖包的时候,可以使用以下命令
composer update
如果只想更新部分依赖
composer update monolog/monolog
5.自动加载
对于库的自动加载信息,Composer 生成了一个 vendor/autoload.php
文件。你可以在你项目的入口文件中引入它
<?php require __DIR__ . '/vendor/autoload.php'; ?>
这使得你可以很容易的使用第三方代码。例如:如果你的项目依赖 monolog,你就可以像这样开始使用这个类库,并且他们将被自动加载。
<?php require __DIR__ . '/vendor/autoload.php'; $log = new Monolog\Logger('name'); $log->pushHandler(new Monolog\Handler\StreamHandler('app.log', Monolog\Logger::WARNING)); $log->addWarning('Foo'); ?>
6.Packagist / Composer 中国全量镜像
由于墙的问题,所以会导致 Composer 的国外镜像经常无法正常的 install
,所以推荐使用国内的镜像,使用方式如下
有两种方式启用本镜像服务:
- 系统全局配置: 即将配置信息添加到 Composer 的全局配置文件 config.json 中。详见”方法一“
- 将配置信息添加到某个项目的 composer.json 文件中。详见”方法二“
方法一: 修改 composer 的全局配置文件
打开命令行窗口(windows用户)或控制台(Linux、Mac 用户)并执行如下命令:
composer config -g repo.packagist composer https://packagist.phpcomposer.com
方法二: 修改当前项目的 composer.json
配置文件:
打开命令行窗口(windows用户)或控制台(Linux、Mac 用户),进入你的项目的根目录(也就是 composer.json
文件所在目录),执行如下命令:
composer config repo.packagist composer https://packagist.phpcomposer.com
上述命令将会在当前项目中的 composer.json
文件的末尾自动添加镜像的配置信息(你也可以自己手工添加):
"repositories": { "packagist": { "type": "composer", "url": "https://packagist.phpcomposer.com" } }
7.使用 Composer 中的 autoload 实现自动加载命名空间
Composer 除了可以帮你安装所需要的依赖包以外,还可以实现自动加载命名空间的功能,当我们自己编写的函数库与类库需要自动加载时,我们就可以通过 composer.json
来实现。它类似于 php 中的 spl_autoload_register()
, 其实如果你去查看 Composer 中的源代码,你会看到它的自动加载功能也是用了 spl_autoload_register()
这个函数。《具体可看此文章详细介绍》
我们在 composer.json
--install-dir
(il peut s'agir d'un chemin absolu ou relatif) 🎜🎜4. Utilisez 🎜🎜Pour commencer à utiliser Composer dans votre projet, Tous. vous avez besoin d'un fichier composer.json
. Ce fichier contient les dépendances du projet et d'autres métadonnées. 🎜🎜Créez d'abord un fichier composer.json
, écrivez le nom du package correspondant et le numéro de version, tel que 🎜{ "autoload": { "psr-4": { "Test\": "test/", "Testtwo\": "testtwo/" } } }
install
dans le répertoire de votre projet (c'est-à-dire le répertoire où se trouve composer.json
). 🎜composer dumpautoload
Windows
, vous pouvez également installer des packages dépendants en appelant le package composer.phar
. 🎜<?php require __DIR__ . '/vendor/autoload.php'; $testClass = new \Test\Testclass(); ?>
composer install
pour accéder à l'installation automatique. Une fois l'installation terminée, un fichier composer.lock
sera généré, qui contient un numéro de version spécifique et. composer.json est soumis ensemble à la gestion des versions. 🎜🎜Enfin, lorsque vous devez mettre à jour les packages de dépendances, vous pouvez utiliser la commande suivante🎜rrreee🎜Si vous souhaitez uniquement mettre à jour certaines dépendances🎜rrreee🎜5. Chargement automatique🎜🎜Pour les informations de chargement automatique de la bibliothèque, Composer génère un. Fichier vendor/ autoload.php
. Vous pouvez l'introduire dans le fichier d'entrée de votre projet🎜rrreee🎜Cela vous permet d'utiliser facilement du code tiers. Par exemple : si votre projet dépend de monologue, vous pouvez commencer à utiliser la bibliothèque comme ceci et elles seront automatiquement chargées. 🎜rrreee🎜6. Image complète de Packagist / Composer Chine🎜🎜En raison de problèmes de mur, les images étrangères de Composer ne peuvent souvent pas s'installer
normalement, il est donc recommandé d'utiliser des images nationales. La méthode d'utilisation est la suivante🎜. 🎜 Il existe deux manières d'activer ce service miroir : 🎜- Configuration globale du système : ajoutez les informations de configuration au fichier de configuration globale de Composer config.json. Pour plus de détails, consultez « Méthode 1 »
- Ajouter des informations de configuration au fichier composer.json d'un projet. Pour plus de détails, voir "Méthode 2"
composer.json
du projet en cours : 🎜🎜Ouvrez la fenêtre de ligne de commande (utilisateurs Windows) ou la console (utilisateurs Linux, Mac), et entrez le répertoire racine de votre projet (c'est-à-dire le répertoire où se trouve le fichier composer.json
), exécutez la commande suivante : 🎜rrreee🎜La commande ci-dessus ajoutera automatiquement les informations de configuration du miroir à la fin du composer.json
dans le projet actuel (vous pouvez également l'ajouter manuellement) :🎜rrreee🎜7. Utilisez le chargement automatique dans Composer pour charger automatiquement l'espace de noms🎜🎜En plus de vous aider à installer les packages de dépendances requis, Composer. peut également implémenter la fonction de chargement automatique de l'espace de noms. Lorsque les bibliothèques de fonctions et de classes que nous écrivons nous-mêmes doivent être chargées automatiquement, nous pouvons y parvenir via composer.json
. C'est similaire à spl_autoload_register()
en PHP. En fait, si vous regardez le code source dans Composer, vous verrez que sa fonction de chargement automatique utilise également spl_autoload_register()
pour cela. fonction. "Pour plus de détails, veuillez consulter cet article pour une introduction détaillée"🎜🎜Nous ajoutons le code suivant dans composer.json
:🎜{ "autoload": { "psr-4": { "Test\\": "test/", "Testtwo\\": "testtwo/" } } }
这个配置文件中有一个 autoload 段,其中有个 《PSR-4》,psr-4 是一个基于 psr-4 规则的类库自动加载对应关系,只要在其后的对象中,以 ”命名空间“: “路径” 的方式写入自己的类库信息修改完成后,之后,在执行下列命令,即可完成自动加载。
composer dumpautoload
注:"psr-4": {"Test\\": "test/"}
中的 "test/" 路径为相对于composer.json
的路径
这个时候,你就可以调用你自己编写的函数库或者类库了
<?php require __DIR__ . '/vendor/autoload.php'; $testClass = new \Test\Testclass(); ?>
注:本文内容参考了《Composer 中文网》,后续还会更新 Composer 其它的实用功能