之前用laravel框架开发时,一直用composer工具来安装开源的依赖库文件,没有自己去开发这样的依赖库。本着学习的心态,准备去实现自己的一些PHP相关的依赖库。
本文是借助他人的文档学习了解的
转载地址: http://blog.jayxhj.com/2016/05/basic-composer-package-development/
Composer
是 PHP 用来管理依赖(dependency)关系的工具。你可以在自己的项目中声明所依赖的外部工具库(libraries),Composer 会帮你安装这些依赖的库文件。
开发 composer 包有以下几个步骤:
1.初始化 composer.json 文件
2.定义命名空间及包名
3.实现包需要实现的功能
4.提交到 GitHub
5.在 Packagist 注册包
初始化 composer.json 文件
在项目目录下通过运行composer init
以命令行的方式设置composer.json
下面介绍其中的一些属性,以及常规的设置
1.name
"name": "antik/curl"
此属性定义包名,以 / 隔开,前面的为供应商名字,后面为包名,供应商代表 Packagist 网站为开发者提供的唯一的名字,用来组织包以及防止命名冲突。所以提交时最好先访问 https://packagist.org/packages/yourvendorname 将 url 中的 yourvendorname 替换为你想要取的名字,查看包名是否已经被注册了。
2.type
"type": "library"
包的安装类型,默认为 library。
composer 原生支持以下4种类型:
- library: 这是默认类型,它会简单的将文件复制到 vendor 目录。
- project: 这表示当前包是一个项目,而不是一个库。
- metapackage: 当一个空的包,包含依赖并且需要触发依赖的安装,这将不会对系统写入额外的文件。因此这种安装类型并不需要一个 dist 或 source.
-
composer-plugin: 一个安装类型为
composer-plugin
的包,它有一个自定义安装类型,可以为其它包提供一个 installler。详细请查看 自定义安装类型。
3.license
许可证。关于许可证,建议看两篇文章,开源项目 license 介绍 、 如何选择 license
4.autoload
此配置下主要是 PSR-4 或者 PSR-0 设置,更推荐使用 PSR-4 标准。
使用 composer validate composer.json
来验证文件是否是有错误
演示的设置 composer.json 的视频:https://asciinema.org/a/45460
提交至 GitHub
按照前面的步骤,一个包就有了基本的骨架,接下来就是上传至 GitHub ,配置项目,集成持续集成服务,发布开源项目许可证。
GitHub 初始化项目时可以选择生成 .gitignore 文件,选择许可证,初始化 README.md 文件,切换至本地的项目目录后,按如下步骤即可将目录上传至 GitHub:
git init # 初始化仓库
git remote set-url origin --push --add git@github.com:jayxhj/geosso.git # 添加远程追踪仓库地址
git add .
git commit
git push origin master
提交至 Packagist
Packagist 为 composer 默认获取包元数据信息的地址,从 Packagist 获取到元数据信息后,再从 GitHub 上拉取代码。因此,当把你开发的包上传至 GitHub 后还需要将其在 Packagist 注册,这样全世界的人都能通过 composer 去拉去你的代码了。
提交至 Packagist 只需三个步骤:
1.注册帐号
2.在 https://packagist.org/packages/submit 提交开发包
3.设置 webhook 以便提交包更新后能及时地同步至 Packagist
自此,一个基本的包开发就结束了。通过 composer 来管理 PHP 的依赖,通过编写 composer package 去扩展自己的类库,通过引入其他的类库来填充自己的功能,就不用重复造轮子了。
网友评论