PHP 的包管理工具 -- Composer

compose

缘起

Composer 是 PHP 的一个包管理和包依赖管理的工具 ( 官方的定义是 "Dependency Manager for PHP" ), 类似 Mac 的 Homebrew, CentOS 的 yum, Windows 的 Chocolatey, 以及 Node.js 的 npm 和 Python 的 pip.

在 Composer 出现之前使用 PHP 第三方包的操作:

1. 上网寻找类库, 从官方或者第三方网站下载源码;
2. 解压, 调试;
3. 假如该类库依赖于另外一个类库, 返回第 1 步;

PS. 可以查看我的另一篇文章-- CentOS 编译安装 PHP 的 Memcached 扩展, 安装 PHP 的 Memcached 插件时, 就需要考虑依赖的库, 如果用 CentOS 的包管理工具 -- yum 就可以比较轻松地解决

这种方式带来的问题:

1. 没有统一的规范的资源仓库, 各种类库散落在互联网的各个角落, 不方便比较和下载; 如果多个类库的作者更新了版本, 需要逐个去搜素下载和调试;
2. 如果第三方网站提供的源码被植入恶意代码, 会引入安全问题;
3. 遇到类库的依赖关系, 需要手动下载和调试;
4. 版本更新不方便. 这就意味着很可能作者更新了版本, 但是你还在使用带 Bug 的旧版本;

---

安装

Composer 要求 PHP 5.3.2 以上 (官方推荐使用 5.3.4 以上, 以避免潜在的问题).
如果在安装时提醒缺少组件, 跟着提示解决即可.

• 在 Mac 终端中依次粘贴下面命令以安装 Composer (考虑安全问题, 更加建议直接到官网拷贝安装命令):

  php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
  

  php composer-setup.php
  

  php -r "unlink('composer-setup.php');"
  

• 安装后就可以使用 php composer.phar 来执行命令;

• 为了全局调用, 可以修改环境变量 mv ./composer.phar /usr/local/bin/composer, 之后就可以直接使用 composer 命令;

composer_installed

---

使用

连接国内的第三方镜像库

由于众所周知的原因, 访问 Composer 官方的 packagist 网站速度比较慢, 可以选用第三方在国内做的全景镜像, 提高速度:

composer config -g repo.packagist composer https://packagist.phpcomposer.com

使用 composer 在已有项目中引入类库

以使用 markdown 为例:

• 1.搜索: 在 Packagist 搜索类库, 选用下载量最大的 cebe/markdown 类库;

• 2.配置: 在项目根目录新建 "composer.json" 文件, 文件内容:

  语法:

  {
      "require":{
          "厂商/类库":"版本"
      }
  }
  

  比如:

  {
       "require":{
          "cebe/markdown":"1.1.1"
      }
  }
  

PS: 配置文件中的 JSON 必须使用"双引号", 而不能使用"单引号" (因为"双引号"是 JSON 标准的规定的)

• 3.安装
  • 2.1 cd 到该项目根目录, 运行 composer install;
  • 2.2 安装完毕后, 可以看到根目录多出来一个 "vendor" 文件夹, 打开文件夹, 可以看到 "cebe" 文件夹, 里面有 "markdown" 的类库源码;

composer_success

• 4.加载
  疑问: 如果我们在项目中用 Composer 安装了十几个类库, 需要逐个 require 加载到我们的项目中吗?
  回答: 不需要. 因为 Composer 的作者已经考虑了这个问题. 打开安装之后生成的 "vendor" 文件, 里面有个 "autoload.php" 文件. 只要引入这个文件, 所有通过 Composer 安装的类库就会全部加载完成:

  require(__DIR__.'/vendor/autoload.php');
  

• 5.如果以后需要新增类库

  • 第一种方法: 使用命令 composer require, 比如 composer require phpunit/phpunit:~5.7, 比如 composer require twbs/bootstrap:4.0.0-beta.3;
  • 第二种方法: 在 "composer.json" 文件中追加, 然后执行 composer update;

  {
      "require":{
          "cebe/markdown":"1.1.1",
          "phpunit/phpunit":"5.7.5"
      }
  }
  

---

通过 composer 直接创建某框架的项目

有些包并不是提供一个特定功能的类库, 而是提供一个完整的框架, 比如说 Laravel 和 yii2.

直接创建项目的 Composer 命令是:

composer create-project 厂商/类库 安装路径 版本

所以用 Composer 直接创建一个 Laravel 或者 yii2 的项目的命令是:

composer create-project laravel/laravel ./my_laravel_demo ~5.5.0

composer create-project yiisoft/yii2 ./my_yii2_demo 2.*

PS. 5.5 是 Laravel 的 LTS (Long Time Support) 版本.

---

如何指定类库版本?

类别	实例	说明
指定版本号	5.7.5	直接指定确切的版本号
指定版本范围	>=5.6.7,<5.7	5.6.7或者以上,但是不到5.7的版本
通配符	5.7.*	相当于>=5.7.0,<5.8.0
波浪号	~5.7.5	相当于>=5.7.5,<5.8.0

---

如何更新类库?

composer update

该命令主要有 2 个作用:

• 升级 composer.json 中的类库, 并自动更新升级其依赖
• 更新自动加载的文件 -- autoload.php

因为执行 composer update 需要比较长的时间, 如果只是需要更新自动加载的文件而不需要升级类库(比如你新建了类), 可以执行 composer dump-autoload.

---

如何删除引入的类库?

composer remove 厂商/类库

比如:

composer remove cebe/markdown

---

参考

• Composer 官网 (注意: 是 getcomposer.org, 而不是 composer.org)
• Composer 对应的PHP包仓库 -- Packagist
• composer 命令详解
• 国内的第三方全景镜像 (推荐用官方源, 但是因为某些原因, 可能会用到国内镜像)

---

题外

公司开始规范开发, 逐步引入 PSR, Laravel 框架, PHPUnit, Composer...
从个人来说, 真的很幸运, 能够在这么一个时期加入公司, 在顺流中借势成长. 这也是为什么写这篇博客的原因 -- 当然, 这也是一个博客系列的开始

---

文章历史

• 2017/01/08 (第一次发布)
• 2017/04/04 增加"连接国内的第三方镜像库"
• 2017/05/25 更新安装 Composer 的方法
• 2017/05/31 介绍 composer dump-autoload 命令
• 2017/06/11 删掉"最小化操作流程"章节, 避免用户困惑; 介绍 composer update 命令; 提示 JSON 必须使用双引号;
• 2017/07/09 增加"安装 PHP 的 Memcached 插件的例子", 反衬包管理工具的好处;
• 2017/09/11 去掉"最小使用方法"章节, 避免用户混淆; 更新 Laravel 的 LTS;

---

如果你觉得我的文章对你有用, 请打个"喜欢", 或者给些改进的建议 ^_