Composer 教程-PHP Tutorial-php.cn

Composer 教程

WBOY

Release： 2016-06-23 13:14:43

Original

1068 people have browsed it

Composer是 PHP 用来管理依赖（dependency）关系的工具。你可以在自己的项目中声明所依赖的外部工具库（libraries），Composer 会帮你安装这些依赖的库文件。

本教程内容来源于 Composer 中文网

英文官网： https://getcomposer.org/

更新日期	更新内容
2015-04-30	Composer 中文版

PHP 开发者该知道的 5 个 Composer 小技巧

Composer 是新一代的PHP依赖管理工具。其介绍和基本用法可以看这篇《 Composer PHP依赖管理的新时代》。本文介绍使用Composer的五个小技巧，希望能给你的PHP开发带来方便。

1. 仅更新单个库

只想更新某个特定的库，不想更新它的所有依赖，很简单：

composer update foo/bar

Copy after login

此外，这个技巧还可以用来解决“警告信息问题”。你一定见过这样的警告信息：

Warning: The lock file is not up to date with the latest changes in composer.json, you may be getting outdated dependencies, run update to update them.

Copy after login

擦，哪里出问题了？别惊慌！如果你编辑了 composer.json，你应该会看到这样的信息。比如，如果你增加或更新了细节信息，比如库的描述、作者、更多参数，甚至仅仅增加了一个空格，都会改变文件的md5sum。然后Composer就会警告你哈希值和 composer.lock中记载的不同。

那么我们该怎么办呢？ update命令可以更新lock文件，但是如果仅仅增加了一些描述，应该是不打算更新任何库。这种情况下，只需 update nothing：

$ composer update nothingLoading composer repositories with package information  Updating dependencies  Nothing to install or update  Writing lock file  Generating autoload files

Copy after login

这样一来，Composer不会更新库，但是会更新 composer.lock。注意 nothing并不是 update命令的关键字。只是没有 nothing这个包导致的结果。如果你输入 foobar，结果也一样。

如果你用的Composer版本足够新，那么你可以直接使用 --lock选项：

composer update --lock

Copy after login

2. 不编辑 composer.json的情况下安装库

你可能会觉得每安装一个库都需要修改 composer.json太麻烦，那么你可以直接使用 require命令。

composer require "foo/bar:1.0.0"

Copy after login

这个方法也可以用来快速地新开一个项目。 init命令有 --require选项，可以自动编写 composer.json：（注意我们使用 -n，这样就不用回答问题）

$ composer init --require=foo/bar:1.0.0 -n$ cat composer.json{    "require": {        "foo/bar": "1.0.0"    }}

Copy after login

3. 派生很容易

初始化的时候，你试过 create-project命令么？

composer create-project doctrine/orm path 2.2.0

Copy after login

这会自动克隆仓库，并检出指定的版本。克隆库的时候用这个命令很方便，不需要搜寻原始的URI了。

4. 考虑缓存， dist包优先

最近一年以来的Composer会自动存档你下载的 dist包。默认设置下， dist包用于加了tag的版本，例如 "symfony/symfony": "v2.1.4"，或者是通配符或版本区间， "2.1.*"或 ">=2.2,<2.3-dev"（如果你使用 stable作为你的 minimum-stability）。

dist包也可以用于诸如 dev-master之类的分支，Github允许你下载某个git引用的压缩包。为了强制使用压缩包，而不是克隆源代码，你可以使用 install和 update的 --prefer-dist选项。

下面是一个例子（我使用了 --profile选项来显示执行时间）：

$ composer init --require="twig/twig:1.*" -n --profileMemory usage: 3.94MB (peak: 4.08MB), time: 0s$ composer install --profileLoading composer repositories with package information  Installing dependencies    - Installing twig/twig (v1.12.2)    Downloading: 100%Writing lock file  Generating autoload files  Memory usage: 10.13MB (peak: 12.65MB), time: 4.71s$ rm -rf vendor$ composer install --profileLoading composer repositories with package information  Installing dependencies from lock file    - Installing twig/twig (v1.12.2)    Loading from cacheGenerating autoload files  Memory usage: 4.96MB (peak: 5.57MB), time: 0.45s

Copy after login

这里， twig/twig:1.12.2的压缩包被保存在 ~/.composer/cache/files/twig/twig/1.12.2.0-v1.12.2.zip。重新安装包时直接使用。

5. 若要修改，源代码优先

当你需要修改库的时候，克隆源代码就比下载包方便了。你可以使用 --prefer-source来强制选择克隆源代码。

composer update symfony/yaml --prefer-source

Copy after login

接下来你可以修改文件：

composer status -v  You have changes in the following dependencies:  /path/to/app/vendor/symfony/yaml/Symfony/Component/Yaml:    M Dumper.php

Copy after login

当你试图更新一个修改过的库的时候，Composer会提醒你，询问是否放弃修改：

$ composer updateLoading composer repositories with package information  Updating dependencies    - Updating symfony/symfony v2.2.0 (v2.2.0- => v2.2.0)    The package has modified files:    M Dumper.php    Discard changes [y,n,v,s,?]?

Copy after login