PHP 的包管理工具 -- Composer

声明 :本文转自  https://www.jianshu.com/p/5954fe55d067  

PHP 的包管理工具 -- Composer

缘起

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

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

上网寻找类库, 从官方或者第三方网站下载源码;

解压, 调试;

假如该类库依赖于另外一个类库, 返回第 1 步;

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

这种方式带来的问题:

没有统一的规范的资源仓库, 各种类库散落在互联网的各个角落, 不方便比较和下载; 如果多个类库的作者更新了版本, 需要逐个去搜素下载和调试;

如果第三方网站提供的源码被植入恶意代码, 会引入安全问题;

遇到类库的依赖关系, 需要手动下载和调试;

版本更新不方便. 这就意味着很可能作者更新了版本, 但是你还在使用带 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命令;

PHP 的包管理工具 -- Composer_第1张图片

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.1cd到该项目根目录, 运行composer install;

2.2 安装完毕后, 可以看到根目录多出来一个 "vendor" 文件夹, 打开文件夹, 可以看到 "cebe" 文件夹, 里面有 "markdown" 的类库源码;

PHP 的包管理工具 -- Composer_第2张图片

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.75.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;

作者:patiencing

链接:https://www.jianshu.com/p/5954fe55d067

來源:

著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

你可能感兴趣的:(PHP 的包管理工具 -- Composer)