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:
     设置环境变量,任何目录下可直接用  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
 
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 有效性检查
 

更多信息参考官方手册。
 
 
posted @ 2016-08-07 15:23  anyeshe  阅读(4214)  评论(1编辑  收藏  举报