PHP包管理工具Composer（作曲家）

在PHP包管理上面，PHP发展的很缓慢，导致的结果就是很少发现程序员会使用像PEAR这样的工具。相反，大多数开发人员会选择他们自己喜欢的框架来处理代码，比如DB交互、ORIM’S、Oauth、Amazon S3整合等。

Composer是一个基于项目的依赖管理器，负责将PHP项目所依赖的包或库安装到项目所在的目录中，默认它不会安装任何数据到全局。它用于取代之前所使用的pear工具。

参考的网站：

官网：https://getcomposer.org/

中文网：http://www.phpcomposer.com/

1 安装Composer

windows操作系统需要下载安装包。https://getcomposer.org/download/

运行Composer-Setup.exe ，注意选择php.exe的路径。

linux系统安装

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

2 简单应用
我们只需要声明一个项目所依赖的包或库即可，此后其他的事情就由Composer来处理了。因此使用Composer最重要的就是在项目目录中编写composer.json配置文件。例如你有一个项目，需要依赖monolog，可以这样写composer.json文件：
{
    "require":
    {
        "monolog/monolog": "1.2.*"
    }
}
有了此文件后，在项目目录中执行composer install，即会在项目目录的vendor/目录下创建其所依赖的库。
另一方面，包含了composer.json的目录，也可以发布出去，让其他人通过composer进行安装。只需要在packagelist网站，把此包传上去即可。

3 配置文件说明

Composer使用json作为其配置文件的格式。在工程的根目录下composer.json所定义的包称为root包。在配置文件中有如下的属性。

3.1 require
格式为： "require":{"vendor-name/package-name":"version", ...}
名字部分会作为vendor下的路径进行创建
版本支持精确的版本号，也支持范围如>=1.0; >=1.0,<2.0; ","作为逻辑与，而"!"作为逻辑或的意思。示例中使用了通配符*
版本也支持tag或branch名称。
类似的有require-dev，前者用于声明项目发布版本的依赖包，后者用于声明项目开发或测试中依赖的包。

3.2 autoload

composer支持PSR-0,PSR-4,classmap及files包含以支持文件自动加载。PSR-4为推荐方式。

3.2.1 Files类型
格式："autoload":{"files":["path/to/1.php","path/to/2.php",...]}
支持将数组中的文件进行自动加载，文件的路径相对于项目的根目录。缺点是麻烦，需要将所有文件都写进配置。

3.2.2 classmap类型
格式："autoload":{"classmap": ["path/to/src1","path/to/src2",...]}
支持将数组中的路径下的文件进行自动加载。其很方便，但缺点是一旦增加了新文件，需要执行dump-autoload命令重新生成映射文件vendor/composer/autoload_classmap.php。

3.2.3 psr-0类型
格式："autoload":{"psr-0":{
                           "name1\\space\\":["path/",...],
                           "name2\\space\\":["path2/",...],
                          }
               }
支持将命名空间映射到路径。命名空间结尾的\\不可省略。当执行install或update时，加载信息会写入vendor/composer/autoload_namespace.php文件。如果希望解析指定路径下的所有命名空间，则将命名空间置为空串即可。
需要注意的是对应name2\space\Foo类的类文件的路径为path2/name2/space/Foo.php

3.2.4 psr-4类型
格式："autoload":{"psr-4":{
                           "name1\\space\\":["path/",...],
                           "name2\\space\\":["path2/",...],
                          }
               }
支持将命名空间映射到路径。命名空间结尾的\\不可省略。当执行install或update时，加载信息会写入vendor/composer/autoload_psr4.php文件。如果希望解析指定路径下的所有命名空间，则将命名空间置为空串即可。
需要注意的是对应name2\space\Foo类的类文件的路径为path2/space/Foo.php，name2不出现在路径中。

PSR-4和PSR-0最大的区别是对下划线（underscore)的定义不同。PSR-4中，在类名中使用下划线没有任何特殊含义。而PSR-0则规定类名中的下划线_会被转化成目录分隔符。

3.3 name
格式："name":"vendor/package"
如果要发布一个包，你需要指定包的名字信息。

3.4 version
格式："version":"1.0.2"
如果要发布一个包，你需要指定包的版本号。版本号的格式为X.Y.Z或vX.Y.Z，其后可以加后缀如-dev,-patch,-alpha,-beta或-RC。除dev外，尾上还可加一个数字，如1.0.0-alpha3。

3.5 description
格式："description":"your own description at here!"
如果要发布一个包，可以指定一个简短的介绍

3.5 type
格式："type":"library"
说明包的类型，支持如下library,project,metapackage,composer-plugin，默认为library

3.6 keywords
格式："keywords":["logging","database","redis"]
一个数组的关键字，用于搜索或过滤时使用。

3.7 homepage
可选的，说明项目的网站地址

3.8 time/license
说明项目的时间和License，时间格式为YY-MM-DD HH:MM:SS

3.9 authors
格式："authors":[
{"name":"ss","email":"ss@ss.com","homepage":"","role":""},...
]
用于说明项目的作者信息，为可选的。

3.10 support
格式："support":{"emial":"","issues":"","forum":"","wiki":"","irc":"" }
用于说明项目的支持信息

3.11 conflict
用于声明与本包有冲突的包的版本，使用类似于require。

3.12 replace
用于声明需要替换的包，使用类似于require

3.13 provided
用于说明本包实现了某个包的接口

3.14 suggest
格式："suggest":{"vendor/package":"Some description!"}
用于说明可选的，用于增强功能的包及说明。

4 命令行工具
有了配置文件后，便可以使用composer命令来执行，有如下命令
init                 进入交互式向导，在当前目录下生成composer.json文件
install 根据配置进行安装
    选项 --prefer-source
           --prefer-dist
           --dry-run
           --dev/--no-dev
           -o 将psr0/4转换为classmap以提升性能
update [package-name ...] 根据配置升级指定的包
search [pattern]                    从packagelist中搜索包
show   [package-name]      显示包的信息
depends package             分析项目中包的依赖
validate    验证配置文件内容
status          检查代码是修改信息
self-update                          升级composer本身
config          配置composer本地或全局选项，可以--list显示所有可配置项   格式为conifg [option] [key] [value...]
create-project vendor/package path version 在指定路径下下载一个项目，默认从packagelist上搜索
dump-autoload                   当类映射中加入新类时，用于更新加载器

5 自动加载

对于composer管理的依赖，如果希望自动加载只需要在文件中加入：require 'vendor/autoload.php'
拿上面的例子，使用依赖的类就十分简单了，使用packet-name\class-name就可以直接访问了。如
$log = new Monolog\Logger();

6 杂项

composer.lock文件用于记录各依赖的版本，如果使用了VCS，即此文件也需要进行提交。因为如果此文件存在，即composer会按照此文件中的版本进行下载，会忽略composer.json文件。如果需要更新版本，则需要修改composer.json，并执行update命令，此时会下载新版本，并更新composer.lock文件。

PHP包管理工具Composer（作曲家）相关推荐

php 的包管理工具 composer
下载地址 https://getcomposer.org/download/ Windows下尝试PHP7提示丢失VCRUNTIME140.DLL的问题解决 # 就算你的系统是64位的,也将x86和 ...
什么是log文件、jar文件、phar文件、Composer、包管理工具？
log文件 log即日志,log文件就是日志文件,记录系统里进行的一些操作,也可以分析日志文件,查看系统里是否有反常行为,从而判断系统是否被入侵. jar文件 jar即Java ARchive,jav ...
Pipenv – 超好用的 Python 包管理工具
pipenv 是什么 pipenv 是 python 官方推荐的包管理工具,集成了 virtualenv.pyenv 和 pip 三者的功能于一身,类似于 php 中的 composer. 我们知道, ...
Pipenv – 超好用的 Python 包管理工具 1
pipenv 是什么 pipenv 是 python 官方推荐的包管理工具,集成了 virtualenv.pyenv 和 pip 三者的功能于一身,类似于 php 中的 composer. 我们知道, ...
govendor包管理工具
包管理工具govendor 一.go找包逻辑在执行 go build 或 go run 命令时,会按照以下顺序去查找包: 当前包下的 vendor 目录向上级目录查找,直到找到 src 下的 ve ...
Nodejs入门 (四) 包管理工具(npm、cnpm、yarn、nvm)
目录一.什么是包管理工具? 二.npm的使用 1.初始化 2.搜索包 3.下载安装包 4.安装包的使用 5.全局安装 6.安装包依赖 7.安装指定版本的包 8.删除依赖 9.配置命令别名 10.np ...
Python包管理工具Distribute的安装
Python包管理工具Distribute的安装 Python的包管理工具常见的有easy_install, setuptools, 还有pip, distribute,那麽这几个工具有什么关系呢,看 ...
pip包管理工具-install执行流程简单查看
pip概述 pip是python提供的包管理工具,该工具提供了对python包的查找.下载.安装与卸载等功能的工具,当前是python中比较主流的管理工具. pip下载安装包的概述 pip工具的本质通 ...
Python的包管理工具Pip
接触了Ruby,发现它有个包管理工具RubyGem非常好用,而且有非常完备的文档系统http://rdoc.info 发现Python下也有相同的工具,包含easy_install和Pip.只是,我没 ...

PHP包管理工具Composer（作曲家）

PHP包管理工具Composer（作曲家）相关推荐

最新文章

热门文章