php composer使用

Composer-PHP中用来管理依赖(dependency)

定义

  1. composer是PHP中用来管理依赖(dependency)关系的工具。你可以在自己的项目中声明所依赖的外部工具库(libraries),Composer会帮你安装这些依赖的库文件。
  2. Composer 需要PHP5.3.2+ 以上的环境来运行。有几个敏感的PHP设置和编译标志也是必需的,但安装程序会发出警告当存在任何不兼容的情况。
  3. Composer 是兼容多平台的,其运行适用于Windows,Linux和OSX。

安装

  1. linux
    • curl -sS https://getcomposer.org/installer | PHP
    • 你可以通过 --install-dir 选项指定 Composer 的安装目录(它可以是一个绝对或相对路径)
    • 全局安装
      mv composer.phar /usr/local/bin/composer
      现在只需要运行 composer 命令就可以使用 Composer 而不需要输入 php composer.phar。
  2. windows
    下载 https://getcomposer.org/Composer-Setup.exe
    windows可能需要设置composer的环境变量
  3. composer -V 查看版本号
    composer -help 查看命令帮助
  4. 参考文献
    http://docs.phpcomposer.com/
  5. composer 中国镜像的使用
    http://pkg.phpcomposer.com/

composer.json 文件说明

  1. require key

     {
         "require": {
             "monolog/monolog": "1.0.*"
         }
     }
    
    • require 需要一个 包名称 (例如 monolog/monolog) 映射到 包版本 (例如 1.0.*) 的对象。
    • 包名称由供应商名称和其项目名称构成
  2. 版本运算符

    • 确切版本 1.0.2
    • 通配符 1.0.* 1.0的所有版本
    • 范围 >、>=、<、<=、!= ,你可以定义多个范围,用逗号隔开,这将被视为一个逻辑AND处理。一个管道符号|将作为逻辑OR处理。
    • 赋值运算符 1.2,1.2相当于>=1.2,<2.0, 允许1.2以上的任何版本,但不包括2.0。你还会看到它的另一种用法,使用 ~ 指定最低版本,但允许版本号的最后一位数字上升。
  3. 执行安装 php composer.phar install

    • 接着前面的例子,这将会找到 monolog/monolog 的最新版本,并将它下载到 vendor 目录。 这是一个惯例把第三方的代码到一个指定的目录 vendor。如果是 monolog 将会创建 vendor/monolog/monolog 目录。
    • 另一件事是 install 命令将创建一个 composer.lock 文件到你项目的根目录中。
    • 如果你正在使用Git来管理你的项目, 你可能要添加 vendor 到你的 .gitignore 文件中。 你不会希望将所有的代码都添加到你的版本库中。
  4. composer.lock - 锁文件

    • 在安装依赖后,Composer 将把安装时确切的版本号列表写入 composer.lock 文件。这将锁定改项目的特定版本。
    • 使用 update 命令。这将获取最新匹配的版本(根据你的 composer.json 文件)并将新版本更新进锁文件。php composer.phar update
    • 如果只想安装或更新一个依赖,你可以白名单它们:
      php composer.phar update monolog/monolog [...]
  5. 自动加载

    • 对于库的自动加载信息,Composer 生成了一个 vendor/autoload.php 文件。你可以简单的引入这个文件,你会得到一个免费的自动加载支持。
      require 'vendor/autoload.php';

    • 你可以在 composer.json 的 autoload 字段中增加自己的 autoloader。

        {
            "autoload": {
                "psr-4": {"Acme\\": "src/"}
            }
        }
      
    • 你可以定义一个从命名空间到目录的映射。此时 src 会在你项目的根目录,与 vendor 文件夹同级。例如 src/Foo.php 文件应该包含 Acme\Foo 类。
      添加 autoload 字段后,你应该再次运行 install 命令来生成 vendor/autoload.php 文件。

    • 引用这个文件也将返回 autoloader 的实例,你可以将包含调用的返回值存储在变量中,并添加更多的命名空间。这对于在一个测试套件中自动加载类文件是非常有用的,例如。

        $loader = require 'vendor/autoload.php';
        $loader->add('Acme\\Test\\', __DIR__);
      

使用示例

  1. 基本命令的使用

  2. 一个最小化的composer.json,切换到项目目录,新建一个composer.json

     {
         "require-dev": {
             "phpunit/phpunit": "4.3.*"
         }
     }
    
  3. 执行 composer install

    • 会创建vendor目录,里面就是相关的代码。
    • 会创建composer.lock文件
    • 会生成 vendor/autoload.php 是自动加载的php文件
posted @ 2015-01-26 15:08  清水煮白菜  阅读(3789)  评论(1编辑  收藏  举报