Composer教程之基础用法 前言 composer.json 安装依赖包 锁文件 Packagist 自动加载

   我们已经安装了Composer,那么如何在我们的项目中使用Composer呢?接下来的部分,我将对实际项目中如何使用Composer进行总结。

composer.json

   要开始在你的项目中使用 Composer,你只需要一个composer.json文件。该文件包含了项目的依赖和其它的一些元数据。从该文件的后缀名可以知道,这是一个JSON格式的文件。

   下面通过一个最简单的示例项目来说明如何使用Composer。项目代码结构如下:

project/
    ├── src/
    │  ├── a.class.php
    │  ├── b.class.php

   接下来,我们要引入Composer。在项目的根目录建立一个composer.json文件。代码结构如下:

project/
    ├── src/
    │  ├── a.class.php
    │  ├── b.class.php
    ├── composer.json

   比如我们的项目现在需要依赖monolog/monolog这样的一个包,那接下来,我们就需要在composer.json中写入以下内容:

 {
    "require": {
        "monolog/monolog": "1.0.*"
    }
 }

   可以看到,require需要一个包名称(例如monolog/monolog)映射到包版本(例如:1.0.*)的对象。而这里最重要的两个概念就是包名称和包版本。

    • 包名称
      包名称由供应商名称和其项目名称构成。通常容易产生相同的项目名称,而供应商名称的存在则很好的解决了命名冲突的问题。它允许两个不同的人创建同样名为json的库,而之后它们将被命名为igorw/jsonseldaek/json。 
    • 包版本
      包版本的门道就多了。比如在前面的例子中,我们引入的monolog版本指定为1.0.*。这表示任何从1.0开始的开发分支,它将会匹配1.0.01.0.2或者1.0.20
      版本约束可以用几个不同的方法来指定。

  • 使用方式 示例 描述
    确切的版本号 1.0.2 可以指定包的确切版本
    范围 >=1.0 >=1.0,<2.0 >=1.0,<1.1&#124;>=1.2 通过使用比较操作符可以指定有效的版本范围。有效的运算符:>>=<<=!=。我们可以定义多个范围,用逗号隔开,这将被视为一个逻辑AND处理。一个管道符号|将作为逻辑OR处理。AND的优先级高于OR。
    通配符 1.0.* 我们可以使用通配符*来指定一种模式。1.0.*>=1.0,<1.1是等效的。
    赋值运算符 ~1.2 这对于遵循语义化版本号的项目非常有用。~1.2相当于>=1.2,<2.0

安装依赖包

   现在我们的示例项目已经有了composer.json文件,接下来我们就需要通过composer命令来安装依赖。安装依赖包步骤如下:

  • 切换到项目的根目录;
  • 执行composer install命令。

   接下来就是等待安装依赖包的过程,安装完成后,我们的项目目录将会变成这个样子:

project/
    ├── src/
    │  ├── a.class.php
    │  ├── b.class.php
    ├── vendor/
    ├── composer.json
    ├── composer.lock

   多了一个vendor文件夹和一个composer.lock文件。对于vendor目录,这是composer的一个惯例,把第三方的代码到一个指定的目录vendor。

锁文件

   在安装依赖后,Composer将把安装时确切的版本号列表写入composer.lock文件。这将锁定该项目的特定版本。

为了保证版本一致问题,请提交你应用程序的composer.lock(包括composer.json)到版本库中。

   这是非常重要的,因为install命令将会检查锁文件是否存在,如果存在,它将下载指定的版本(忽略composer.json文件中的定义)。

   这意味着,任何人建立项目都将下载与指定版本完全相同的依赖。我们的持续集成服务器、生产环境、你团队中的其他开发人员、每件事、每个人都使用相同的依赖,从而减轻潜在的错误对部署的影响。

   如果不存在composer.lock文件,Composer将读取composer.json并创建锁文件。同时,这也意味着如果我们的的项目依赖更新了新的版本,我们将不会获得任何更新。此时要更新依赖版本则需使用update命令。这将获取最新匹配的版本(根据composer.json文件)并将新版本更新进锁文件。

composer update

Packagist

   Packagist是什么?Packagist是Composer的主要资源库。一个Composer的库基本上是一个包的源:记录了可以得到包的地方。Packagist的目标是成为大家使用库资源的*存储平台。这意味着我们可以require那里的任何包。

   我们可以访问https://packagist.org来浏览和搜索我们需要的资源包。

自动加载

   归根到底,Composer是一个依赖管理的工具。我们使用Composer将对应的依赖包下载下来以后,如何在我们的项目中进行使用呢?对于这一点,Composer也想的很周到。

   已经存在的库,我们要把它加载到我们的项目中,对于库的自动加载信息,Composer生成了一个vendor/autoload.php文件。我们可以简单的引入这个文件,这样就会得到一个免费的自动加载支持。而这一切都是Composer来帮助我们完成的,我们只需要在应用层使用即可。例如:

require 'vendor/autoload.php';

   这使得我们可以很容易的使用第三方代码。例如:如果项目依赖monolog,我们就可以像这样开始使用这个类库,并且他们将被自动加载。

$log = new MonologLogger('name');
$log->pushHandler(new MonologHandlerStreamHandler('app.log', MonologLogger::WARNING));
$log->addWarning('Foo');