一、关于composer
Composer 是PHP5.3
以上 的一个依赖管理工具
。它允许你声明项目所依赖的代码库,它会在你的项目中为你安装他们。有了它我们就可以轻松的使用一个命令
将其他优秀代码引用到我们的项目中来。
二、依赖包管理工具
java有maven
,前端有npm
,安卓有Gradle
,作为世界上最好的语言
也就有了composer
三、composer的优势
- 你有一个项目依赖于若干个库。
- 其中一些库依赖于其他库。
- 你声明你所依赖的东西。
- Composer 会找出哪个版本的包需要安装,并安装它们(将它们下载到你的项目中)。
四、composer常用命令
composer require
:安装一个软件包composer update
:会检测新版本包需要的环境和依赖自动实现工具包的升级composer install
:如果没有composer.json文件,会安装composer.json中的依赖composer init
:会初始化一个composer.json配置文件
五、composer的安装
六、手写一个composer包
在站点下新建一个目录,名为blog
。
1、目录下执行:composer init
执行完后,让我们输入一个包名,我就叫guangtouqiang/blog
把。
包名name
- 包的名称,它包括供应商名称和项目名称,使用 / 分隔。
- 对于需要发布的包(库),这是必须填写的。
- 例如,phpmailer/phpmailer
2、执行guangtouqiang/blog
:
接下来让输入描述。
描述description
- 一个包的简短描述。通常这个最长只有一行。
- 对于需要发布的包(库),这是必须填写的。
3、输入描述this is guangtouqiang test bag
4、输入作者名称(可选)
作者authors
- 这个对象必须包含以下的所有属性。
- name: 作者的姓名,通常使用真名。
- email: 作者的 email 地址。
- homepage: 作者主页的 URL 地址。
- role: 该作者在此项目中担任的角色(例:开发人员 或 翻译)。
5、输入最低稳定版本
可用的稳定性标识:dev、alpha、beta、RC、stable。
,一般选择dev
。
6、输入包类型
包类型type
- 包的安装类型,默认为
library。
- library: 这是默认类型,它会简单的将文件复制到 vendor 目录。
- project: 这表示当前包是一个项目,而不是一个库。例:框架应用程序 Symfony standard edition,内容管理系统 SilverStripe installer 或者完全成熟的分布式应用程序。使用 IDE 创建一个新的工作区时,这可以为其提供项目列表的初始化。
- metapackage: 当一个空的包,包含依赖并且需要触发依赖的安装,这将不会对系统写入额外的文件。因此这种安装类型并不需要一个 dist 或 source。
- composer-plugin: 一个安装类型为 composer-plugin 的包,它有一个自定义安装类型,可以为其它包提供一个 installler。详细请查看 自定义安装类型。
默认为 library
我们选择1,library
即可!
7、需要输入开源协议
选择输入GPL,LGPL,BSD,MIT,Apache
这些开源协议即可:
8、是否依赖于其它包,是否依赖于其它环境,这边都yes即可。
Search for a package
:选择搜索php。
9、生成成功。
此时,目录下已经有个composer
这些配置:
七、composer目录的修改
看下刚刚生成的composer.json
:
{
"name": "guangtouqiang/blog",
"description": "this is guangtouqiang test bag",
"type": "1",
"require": {
"php": "^7.0"
},
"license": "Apache-2.0",
"authors": [
{
"name": "guangtouqiang",
"email": "xiaozhengguo521@gmail.com"
}
],
"minimum-stability": "dev"
}
再次基础上增加:
{
"name": "guangtouqiang/blog",
"description": "this is guangtouqiang test bag",
"type": "1",
"require": {
"php": "^7.0"
},
"license": "Apache-2.0",
"authors": [
{
"name": "guangtouqiang",
"email": "xiaozhengguo521@gmail.com"
}
],
"minimum-stability": "dev",
"autoload": {
"psr-4": {
"guangtouqiang\\": "src/guangtouqiang"
}
}
}
命令行执行:composer dump-autoload
,更新composer的命名空间与文件夹映射关系。
同样,需要新建一个src
和guangtouqiang
的文件夹:
在根目录新建个index.php
测试一波:
输出:
注意命名空间的层级与文件夹层级是否相同,类名与文件名相同才能自动加载。
八、将写好的composer包上传
1、在github上新建个仓库
2、将本地的composer包上传到新仓库
git init
git add .
git commit -m "xxx"
git remote add origin 你的远程仓库地址
git push -u origin master
3、登录https://packagist.org/packages/submit
4、将你github上的仓库地址复制进去:
5、配置webhook:
6、复制上图地址到github。
添加webhook
:
这时候,github仓库与packagist已经建立了关联。但是还需要进行发布正式版本才能使用。
7、打版本标签
git tag -a v1.0.1 -m "第一版"
git push origin v1.0.1
此时,已经标签成功了,从packagist能看到我们所有的版本。
执行composer require xx/xxx
就能供别人使用啦。
九、总结
关于composer.json详细描述请参照:composer.json详细使用