composer php依赖管理工具

#composer是什么
Composer 是 PHP 的一个依赖管理工具。它允许你申明项目所依赖的代码库，它会在你的项目中为你安装他们。
composer出现之前我们php项目依赖管理大部分都是手动管理，（当然也可能会用到pear，pear是全局安装的）。
 
#Composer 解决了那些问题
a) 你有一个项目依赖于若干个库。
b) 其中一些库依赖于其他库。
c) 你声明你所依赖的东西。
d) Composer 会找出哪个版本的包需要安装，并安装它们（将它们下载到你的项目中）。

---

#系统要求
windows，linux，osx
php5.3.2+
git，svn，hg （取决于依赖包用的版本控制）
 
#安装
windows：
     https://getcomposer.org/Composer-Setup.exe  下载安装；
     设置环境变量，任何目录下可直接用  composer  命令；
 
*inux
     curl -sS https://getcomposer.org/installer | php -- --install-dir=bin
     mv composer.phar /usr/local/bin/composer
     ( composer.phar 是composer的二进制执行程序，是一个phar包 )
 
MAC
     推荐brew安装
     brew update
     brew tap josegonzalez/homebrew-php
     brew tap homebrew/versions
     brew install php55-intl
     brew install josegonzalez/php/composer
 
安装完成之后，-v选项查看详情

#使用

composer依赖管理通过  composer.json 文件配置依赖关系。
 
json结构，最重要的key是 require  定义依赖关系；
{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}
结构是     包名 ：版本

包名格式：供应商/包名  这种结构的好处是运行多个人开发相同的包名，通过供应商名称区分

版本：

~1.2 理解 >= 1.2, <2.0    最后一个点后面的可以变   ~1.2.3   >=1.2.3, < 1.3

 
依赖关系配置好之后： composer install  会安装包到  vendor/包名 目录下    vendor目录推荐放在版本控制外（.gitignore）   如下：

同时会写一个 composer.lock 文件，里面详细记录安装的版本信息，composer.lock 和  composer.json这两个文件必须加入版本控制中，这样别人初始化项目的时候就会读取lock文件安装指定的版本，即使依赖包有新版本发布，降低了部署风险。（install程序首先检查有没有lock文件）

composer install 运行过程：

由于有墙，这2个站访问不是很稳定，即使能访问到速度也很慢，强烈推荐  composer中国全量镜像  项目composer.json中加入如下配置:

"repositories": {
    "packagist": {
        "type": "composer",
        "url": "https://packagist.phpcomposer.com"
    }

}

 详细参考官网：http://pkg.phpcomposer.com/

 
更新依赖包：

     php composer.phar update

只跟新一个包
     php composer.phar update monolog/monolog [...]
 
#自动加载
composer为我们做好了自动加载的操作，项目中我们只需要引入即可：

     require 'vendor/autoload.php';

也可以定义自己的autoload：

     "autoload": {

            "classmap": [

                 "database"

            ],

            "psr-4": {

                 "App\\": "app/"

            }

     }

注册一个psr-4的autoload到App的命名空间，App命名空间映射到目录app 和vendor同级，修改autoload后必须重新运行

composer install  以便重新生成autoload.php
psr-4：http://www.php-fig.org/psr/psr-4/

 
composer dumpautoload

---

# 包
只要一个文件夹里包含 composer.json 它就是一个包，如果定义了一个require这是一个依赖于其他包的包。

项目本身就是一个包  只是没有名字  通过 composer.json 中的 name 来定义 

{
    "name": "acme/hello-world",
    "require": {
        "monolog/monolog": "1.0.*"
    }

}

#平台软件包
不是由composer安装的包视为平台软件包，如php本身  通过下面命令查看

 
输出结果中出现的限制都可以用于定义依赖

 

---

# 使用composer管理项目
背景：团队里有自己的框架，库。现在需要做一个新项目。这时候可以使用composer管理

 
步骤一

     把公共的框架和库做成一个composer包， push到git上（svn也行）能访问到就行

      
步骤二

    在我们新项目的composer.json中，定义依赖

     
步骤三

    执行  composer  install 这个时候项目依赖就会自动安装。

 
最终目录结构如下：

 
如果打算开源某个公共库，可以发布到 composer的packageist   地址：https://packagist.org/    提交项目就行；

 

---

# yii2 分析
目前主流php框架新版本都开始composer，如 yii2，laravel等；

{
    "name": "yiisoft/yii2-app-basic",  // 包名称  供应商/项目名  必须
    "description": "Yii 2 Basic Project Template", // 包描述  最长一行  对于要发布的包是必须字段
    "keywords": ["yii2", "framework", "basic", "project template"], //该包相关的关键词的数组。这些可用于搜索和过滤  可选
    "homepage": "http://www.yiiframework.com/",  // 该项目网站的 URL 地址  可选
    "type": "project",  // 包的安装类型，默认为 library 简单复制到vendor中。 project这表示当前包是一个项目，而不是一个库
    "license": "BSD-3-Clause", // 许可协议
    "support": {  // 获取项目支持的向相关信息对象
        "issues": "https://github.com/yiisoft/yii2/issues?state=open",
        "forum": "http://www.yiiframework.com/forum/",
        "wiki": "http://www.yiiframework.com/wiki/",
        "irc": "irc://irc.freenode.net/yii",
        "source": "https://github.com/yiisoft/yii2"
    },
    "minimum-stability": "stable", // 这定义了通过稳定性过滤包的默认行为
    "require": {
        "php": ">=5.4.0",
        "yiisoft/yii2": ">=2.0.5",
        "yiisoft/yii2-bootstrap": "*",
        "yiisoft/yii2-swiftmailer": "*"
    },
    "require-dev": { // 这个列表是为开发或测试等目的，额外列出的依赖
        "yiisoft/yii2-codeception": "*",
        "yiisoft/yii2-debug": "*",
        "yiisoft/yii2-gii": "*",
        "yiisoft/yii2-faker": "*"
    },
    "config": { // 仅用于项目
        "process-timeout": 1800 // 处理进程结束时间
    },
    "scripts": { // Composer 允许你在安装过程中的各个阶段挂接脚本
        "post-create-project-cmd": [
            "yii\\composer\\Installer::postCreateProject"
        ]
    },
    "extra": { // 任意的，供 scripts 使用的额外数据
        "yii\\composer\\Installer::postCreateProject": {
            "setPermission": [
                {
                    "runtime": "0777",
                    "web/assets": "0777",
                    "yii": "0755"
                }
            ],
            "generateCookieValidationKey": [
                "config/web.php"
            ]
        },
        "asset-installer-paths": {
            "npm-asset-library": "vendor/npm",
            "bower-asset-library": "vendor/bower"
        }
    }
}

---

#常用命令
composer init  以交互的方式创建 composer.json

 
composer install  处理依赖关系，安装到vendor下

 
composer update 获取最新版本，并更新lock文件

 
composer search 搜索依赖

 
composer validate 有效性检查

 

---

更多信息参考官方手册。

 
 

composer php依赖管理工具的相关教程结束。