Composer 学习笔记

时间:2021-08-07 16:12:34

Composer 是 PHP 的一个依赖管理工具(据说是最优秀的)。它允许你申明项目所依赖的代码库,它会在你的项目中为你安装他们。目前很多项目以Composer 作为依赖管理工具,目前正在学习yii2框架,以yii2为例学习一些常用命令。

安装


具体安装方式可参照composer中文文档,分 *nix 和 win 平台:

安装完成后测试是否安装成功

composer -V

Composer 学习笔记

输入图中所示的命令,出现类似图中的结果,表面安装成功。

镜像是什么鬼?


不知道镜像的天朝程序员,不是一个优秀的码农。

由于强力的 GFW 导致无法上一些优秀的国外网站,所以各种镜像服务器诞生了,帮我们把这些网站上的资源都导入到了国内,我们通过修改一个配置就可以下载这些资源了。而且这些资源都是定期同步的,不需要担心资源陈旧问题。

也就是因为这个,N多人望而却步,到现在都不敢用 Composer,感觉好可惜,这么好的工具。

目前唯一还算稳定的 Composer 镜像只有 Packagist / Composer 中国全量镜像 这一家了,虽然偶尔抽风。
使用方法也超简单,推荐全局配置镜像。

打开命令行窗口(windows用户)或控制台(Linux、Mac 用户)并执行如下命令:

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

Composer 学习笔记

使用 Composer


常用命令:

1、初始化命令

composer init

Composer 学习笔记

该命令通过交互的方式在当前目录下(一般为项目根目录)生成composer.json的配置文件(也可手动编辑生成),yii2中的配置文件如下:

 {
     "name": "yiisoft/yii2-app-basic", //包的名称,它包括供应商名称和项目名称,使用 / 分隔
     "description": "Yii 2 Basic Project Template", //一个包的简短描述
     "keywords": ["yii2", "framework", "basic", "project template"] ,//该包相关的关键词的数组。这些可用于搜索和过滤
     "homepage": "http://www.yiiframework.com/", //该项目网站的 URL 地址。
     "type": "project", //包的安装类型,project: 表示当前包是一个项目,而不是一个库。
     "license": "BSD-3-Clause", //包的许可协议
     "support": { //获取项目支持的向相关信息
         "issues": "https://github.com/yiisoft/yii2/issues?state=open",
         "forum": "http://www.yiiframework.com/forum/",
         "wiki": "http://www.yiiframework.com/wiki/",
         "irc": "irc://irc.freenode.net/yii",
         "source": "https://github.com/yiisoft/yii2"
     },
     "minimum-stability": "stable",//定义了通过稳定性过滤包的默认行为。默认为 stable(稳定)。
     "require": { //必须的软件包列表,除非这些依赖被满足,否则不会完成安装
         "php": ">=5.4.0",
         "yiisoft/yii2": ">=2.0.5",
         "yiisoft/yii2-bootstrap": "*",
         "yiisoft/yii2-swiftmailer": "*"
     },
     "require-dev": { //这个列表是为开发或测试等目的,额外列出的依赖。
         "yiisoft/yii2-codeception": "*",
         "yiisoft/yii2-debug": "*",
         "yiisoft/yii2-gii": "*",
         "yiisoft/yii2-faker": "*"
     },
     "config": { //仅用于项目的这一组composer配置
         "process-timeout": 1800 //处理进程结束时间,例如:git 克隆的时间。Composer 将放弃超时的任务。如果你的网络缓慢或者正在使用一个巨大的包,你可能要将这个值设置的更高一些。
     },
     "scripts": { //在安装过程中的各个阶段挂接脚本
         "post-create-project-cmd": [
             "yii\\composer\\Installer::postCreateProject"
         ]
     },
     "extra": { //任意的,供 scripts 使用的额外数据  本例中用于生成yii2的主要目录权限和CookieValidationKey
         "yii\\composer\\Installer::postCreateProject": {
             "setPermission": [
                 {
                     "runtime": "0777",
                     "web/assets": "0777",
                     "yii": "0755"
                 }
             ],
             "generateCookieValidationKey": [
                 "config/web.php"
             ]
         },
         "asset-installer-paths": {
             "npm-asset-library": "vendor/npm",
             "bower-asset-library": "vendor/bower"
         }
     }
 }

2、安装依赖包命令

composer install

Composer 学习笔记

该命令从当前目录读取 composer.json 文件,处理了依赖关系,并把其安装到 vendor 目录下,如果当前目录下存在 composer.lock 文件,它会从此文件读取依赖版本,而不是根据 composer.json 文件去获取依赖。这确保了该库的每个使用者都能得到相同的依赖版本。

执行成功结果类似:

Composer 学习笔记

3、更新依赖包命令

composer update

Composer 学习笔记

该命令将获取依赖的最新版本,并将版本号写入 composer.lock文件,如果只更新某几个文件,可以在后面指定

更新yii2项目中的依赖,执行结果类似下图:

Composer 学习笔记

4、添加依赖命令

composer require  

Composer 学习笔记

增加新的依赖包到当前目录的 composer.json 文件中,并且安装该依赖

5、全局执行命令

composer global require "fxp/composer-asset-plugin:~1.1.1"

命令允许你在composer主目录下执行其它命令,像 installrequire 或 update

并且如果你将主目录下的/vendor/bin路径 加入到了 $PATH 环境变量中,你就可以用它在命令行中安装全局应用

以yii2中安装 Composer Asset 插件为例:

Composer 学习笔记

安装成功的话现在Composer Asset 插件就可以在全局范围使用了。

6、创建项目命令

创建yii2基本应用程序模板项目的命令:

composer create-project yiisoft/yii2-app-basic basic 2.0.8

创建yii2高级应用程序模板项目的命令:

composer create-project yiisoft/yii2-app-advanced yii-2.0.8 2.0.8

注:实际执行命令时路径应选择自己的web目录路径,如按照截图中执行将在F:/www目录下创建名称为basic或者yii-2.0.8项目

以创建yii2基本应用程序模板项目为例:

Composer 学习笔记

Composer 学习笔记

Composer 学习笔记

Composer 学习笔记

7、更新composer命令

composer self-update

Composer 学习笔记