编写自己的composer项目
composer
的出现给php
开发带来极大的便利, 配合phpunit
的测试工具, 也可以更好的规范php开发. 尽管这些标准不是官方提供的, 但现在大部分的php框架几乎都按照这个规范去开发和管理项目. 这里先介绍一下怎么去编写自己的composer
项目
一. 创建github
项目
可以参考我的项目地址 https://github.com/yin32167/cpstpl
config
配置文件存放的位置src
源代码tests
测试文件位置
.gitignore
git忽略文件LICENSE.md
项目许可证README.md
项目介绍composer.json
composer配置文件phpunit.xml
phpunit配置文件
1. 关于.gitignore
配置
执行
composer install
会生成composer.lock
文件, 并将相关的依赖下载到vendor
文件夹, 所以这两个文件是需要忽略的
2. 关于LICENSE.md
内容
这个看大家项目的具体目的, 对于开源项目来讲, 用MIT
协议比较常见
3. 关于README.md
内容
主要是介绍项目基础信息及用法, 项目的github
页面会将内容显示出来, 以markdown
格式
二. 配置 composer
- 安装
composer
:mac
用户可以使用homebrew
,windows
用户可以直接下载安装包安装
https://pkg.phpcomposer.com/#how-to-install-composer
注意确保
composer
命令在环境变量中
- 配置中国镜像: 由于国外镜像速度太慢, 影响开发效率
- 编辑配置文件
require
: 由于composer
是php
的包管理工具, 所以需要依赖php环境, 这里我们建议使用php7
以上版本, 毕竟各方面都有很大的提升require-dev
: 一般加载测试相关的包autoload
: 指定自动加载的文件夹, 现在一般采用psr-4
标准
会生成
composer.lock
及vendor
文件夹. 如果修改了composer.json
, 但之前已经生成了composer.lock
, 此时需要执行composer update
, 配置才能生效
三. 添加 phpunit
- 安装
Windows 用户具体参见 http://www.phpunit.cn/manual/current/zh_cn/installation.html#installation.phar.windows
一定要确保phpunit
在环境变量中
- 编辑配置文件
phpunit.xml
bootstrap
指定启动测试时, 先加载vendor/autoload.php
testsuite
指定测试文件的目录filter
过滤依赖文件的位置
- 执行测试样例
四. 上传到 packagist
- 先注册, 需要关联
github
- 创建
composer
模块名称, 尽量和github
一致就好 - 检测提交
如果你没按照它的规范, 会提示失败, 并给出原因, 只需按照修改即可.
附:
如果github
中存在多个branch
, 则在生成composer
模块的时候会打包对应dev-分支名
版本号, 如果不希望出现dev
, 也就是看起来是正式版本, 需要在github
打tag
, 此时会以tag
的名称作为版本号而不会加上dev
原文地址:https://www.cnblogs.com/php-linux/p/10544924.html