首页 > 代码库 > Composer的学习
Composer的学习
来自http://blog.sina.com.cn/s/blog_6262a50e0101b5ut.html
简介
composer是PHP中的一个依赖关系管理工具。只要(按指定格式)声明项目所依赖的库,composer就可以为我们安装这些库。
依赖关系管理
composer不是包管理器。不错,它处理“包”或库,但他的管理基于单个项目,它把库安装到项目中的一个目录中(例如:vendor)。缺省情况下,composer从不在全局范围安装任何东西。因此,composer是一个依赖关系管理器。
这并不是种全新的思想,composer受到node的npm和ruby的bundler的启发。但对PHP来说,还没有这样的工具。
composer要解决的问题是:
l 我们有一个项目,依赖好几个库。
l 这些库中某些又依赖于别的库。
l 我们声明我们依赖的库
l composer找到需要安装哪个包的哪个版本,并安装(这意味着composer把他们下载到我们的项目中)。
声明依赖关系
假定我们创建了一个项目,需要一个库做日志记录。我们决定使用monolog。为了把monolog加到项目中,我们只需要创建一个描述项目依赖关系的文件composer.json。
{
"require": {
"monolog/monolog": "1.0.*"
}
}
这里只需简单地说明我们的项目需要某个monolog/monolog包,以1.0开始的任何版本都可以。
安装
本地下载
要获取composer,我们需要做两件事。第一件是安装composer(再说一遍,把它下载到我们的项目目录中):
$ curl –s https://getcomposer.org/installer | php
这个命令会检查PHP的几个设置然后把composer.phar下载到我们的工作目录。这个文件是composer程序。它是一个PHAR(PHP archive),PHAR是PHP的一种文档格式,可以在命令行运行。
通过--install-dir选项,可以把composer安装到指定目录中(可以是绝对路径,也可以是相对路径):
$curl –s https://getcomposer.org/installer | php -- --install-dir=bin
全局下载
这个文件可以放在任何地方。如果把它放在PATH指定的路径中,就可以全局访问了。在unix类的系统中上,可以把它变成可执行文件,运行时可以不指定php。
$ curl -s https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
然后,运行composer时只需运行composer。
使用composer
下一步,运行install命令来解析和下载依赖库:
php composer.phar install
这个命令会把monolog下载到vendor/monolog/monolog目录中。
自动加载
除了下载库之外,composer还准备了一个自动加载文件,可以自动加载它下载的库中的所有类。要使用自动加载,只要在代码的引导过程中加上:
require ‘vendor/autoload.php‘;
好了,开始使用monolog吧!要学习composer的更多知识,请阅读“基本用法”一章。
基本用法:http://docs.phpcomposer.com/01-basic-usage.html
来自http://blog.csdn.net/think2me/article/details/38456931
{
"require": {
"monolog/monolog": "1.11.*@dev"
}
}
你可以看到, require
需要一个 包名称 (例如 monolog/monolog
) 映射到 包版本 (例如 1.11.*@dev
) 的对象。composer install
$ composer install
命令执行完成后,就开始自动下载了,我们打开文件夹:install
命令将会检查锁文件是否存在,如果存在,它将下载conposer.lock指定的版本(忽略 composer.json
文件中的定义)。如果不存在 composer.lock
文件,Composer 将读取 composer.json
并创建锁文件。
我们想想这样有什么作用呢?假设一个场景,多人开发,肯定会有人新的人开发完成将要后续开发,那么他肯定会去更新composer.json的依赖关系,那么其他人更新后,也会同样去更新,这样就乱了。他本来不想去更新,只想用原来的。所以有个这个composer.lock
文件,所有的人都会用一样的依赖关系版本。等全部都开发好了。再将这个composer.lock文件删掉就可以了。
update
命令。这将获取最新匹配的版本(根据你的 composer.json
文件)并将新版本更新进锁文件composer.lockupdate
命令,它将重新生成lock文件$ composer update
如果只想安装或更新一个依赖,你可以这样单独更新它:
$ composer update monolog/monolog [...]
4. 包版本的规则是啥
在前面的例子中,我们引入的 monolog 版本指定为 1.0.*
。这表示任何从 1.0
开始的开发分支,它将会匹配 1.0.0
、1.0.2
或者 1.0.20
。
版本约束可以用几个不同的方法来指定。
名称 | 实例 | 描述 |
---|---|---|
确切的版本号 | 1.0.2 |
你可以指定包的确切版本。 |
范围 | >=1.0 >=1.0,<2.0 >=1.0,<1.1|>=1.2 |
通过使用比较操作符可以指定有效的版本范围。 有效的运算符: > 、>= 、< 、<= 、!= 。 你可以定义多个范围,用逗号隔开,这将被视为一个逻辑AND处理。一个管道符号 | 将作为逻辑OR处理。 AND 的优先级高于 OR。 |
通配符 | 1.0. |
你可以使用通配符 来指定一种模式。1.0.* 与>=1.0,<1.1 是等效的。 |
赋值运算符 | ~1.2 |
这对于遵循语义化版本号的项目非常有用。~1.2 相当于>=1.2,<2.0 。想要了解更多,请阅读下一小节。 |
5. 下一个重要版本(波浪号运算符)
~
最好用例子来解释: ~1.2
相当于 >=1.2,<2.0
,而 ~1.2.3
相当于 >=1.2.3,<1.3
。正如你所看到的这对于遵循 语义化版本号 的项目最有用。一个常见的用法是标记你所依赖的最低版本,像 ~1.2
(允许1.2以上的任何版本,但不包括2.0)。由于理论上直到2.0应该都没有向后兼容性问题,所以效果很好。你还会看到它的另一种用法,使用 ~
指定最低版本,但允许版本号的最后一位数字上升。
默认情况下只有稳定的发行版才会被考虑在内。如果你也想获得 RC、beta、alpha 或 dev 版本,你可以使用 稳定标志。你可以对所有的包做 最小稳定性 设置,而不是每个依赖逐一设置。
require ‘vendor/autoload.php‘;
我们在对的路径加载这一句就可以了。比如,我们在加载了这一句后,想调用mongolog,我们就可以直接用了,不需要另外加载它:$log = new Monolog\Logger(‘name‘);
$log->pushHandler(new Monolog\Handler\StreamHandler(‘app.log‘, Monolog\Logger::WARNING));
$log->addWarning(‘Foo‘);
很方便。 ______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 0209bd31a0ac3aeb2a68fc81e2d03c71072bef33
Usage:
[options] command [arguments]
Options:
–help -h Display this help message.
–quiet -q Do not output any message.
–verbose -v Increase verbosity of messages.
–version -V Display this application version.
–ansi Force ANSI output.
–no-ansi Disable ANSI output.
–no-interaction -n Do not ask any interactive question.
–profile Display timing and memory usage information
–working-dir -d If specified, use the given directory as working directory
.
Available commands:
about Short information about Composer
archive Create an archive of this composer package
config Set config options
create-project Create new project from a package into given directory.
depends Shows which packages depend on the given package
diagnose Diagnoses the system to identify common errors.
dump-autoload Dumps the autoloader
dumpautoload Dumps the autoloader
help Displays help for a command
init Creates a basic composer.json file in current directory.
install Installs the project dependencies from the composer.lock file
if present, or falls back on the composer.json.
list Lists commands
require Adds required packages to your composer.json and installs the
m
run-script Run the scripts defined in composer.json.
search Search for packages
self-update Updates composer.phar to the latest version.
selfupdate Updates composer.phar to the latest version.
show Show information about packages
status Show a list of locally modified packages
update Updates your dependencies to the latest version according to
composer.json, and updates the composer.lock file.
validate Validates a composer.json
这里面有很多命令,我们可以一个个的尝试下看看。最常用的就是create-project命令了,我们常见的框架symfony 和 Laravel 框架就是这种方式的:composer create-project laravel/laravel your-project-name 2.1.2
composer create-project symfony/framework-standard-edition your-project-name 2.1.2
8. composer的一些常用的命令:
composer list 列出所有可用的命令
composer init 初始化composer.json文件(就不劳我们自己费力创建啦),会要求输入一些信息来描述我们当前的项目,还会要求输入依赖包
composer install 读取composer.json内容,解析依赖关系,安装依赖包到vendor目录下
composer update 更新最新的依赖关系到compsoer.lock文件,解析最新的依赖关系并且写入composer.lock文件
composer search packagename 搜索包,packagename替换为你想查找的包名称
composer require packagename 添加对packagename的依赖,packagename可修改为你想要的包名称
composer show packagename
composer self-update 更新 composer.phar文件自身
composer command --help 以上所有命令都可以添加--help选项查看帮助信息
Composer的学习