声明 :本文转自 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命令;
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" 的类库源码;
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
国内的第三方全景镜像(推荐用官方源, 但是因为某些原因, 可能会用到国内镜像)
题外
公司开始规范开发, 逐步引入 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
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。