当前,2.x新版本发布的流程,主要如下。
重要的信息
PhalApi 2.x Kernal核心包(底层代码在这里):https://github.com/phalapi/kernal
PhalApi 2.x 项目(直接可用于开发的项目):https://github.com/phalapi/phalapi
第1步、修改更新日志
文档展示页面:http://docs.phalapi.net/#/v2.0/changelog
对应编辑的代码位置在(码云):https://gitee.com/dogstar/phal ... og.md
第2步、对Kernal包进行版本升级
修改核心代码composer包,即Kernal包,Github项目地址:https://github.com/phalapi/kernal
发布前,需要修改新版本的版本号。修改源文件:https://github.com/phalapi/ker ... s.php
然后,把框架版本号PHALAPI_VERSION进行更新。
/**
* 框架版本号
*/
defined('PHALAPI_VERSION') || define('PHALAPI_VERSION', '2.4.2');
最后,在Github项目创建一个新的版本发布:https://github.com/phalapi/kernal/releases
版本说明与前面的更新日志保持一致。到这一步,其他开发人员进行:composer update 后就可以进行框架的更新了(前提是项目使用的版本号要对应上)。
第3步,对PhalApi项目进行升级
下一步,同样修改PhalApi项目中README中的版本号。
代码位置是:https://github.com/phalapi/pha ... ME.md
这里还有最重要的一步,就是要在此项目,在本地进行一下composer update,确保当前已把Kernal更新到最新版本。
$ composer update
同样,在Github项目创建一个新的版本发布:https://github.com/phalapi/phalapi/releases,注意,版本应该与Kernal的保持一致,避免混淆。更新内容也一样。
到这一步,使用PhalApi的新开发人员,就能享受到最新版本的使用了。
第4步,对官方的在线示例进行升级
在服务器上,进行composer update,将在线示例demo升级到最新版本。
在线示例地址:http://demo.phalapi.net/docs.php
第5步,对旧版本进行更新通知
代码位置:https://gitee.com/dogstar/Phal ... n.php
更新2.x 系列的版本号,通知旧版本的开发人员进行版本升级。
// 两个系列版本
$lastestVersion = substr($version, 0, 1) == '1' ? '1.4.1' : '
2.4.0';
效果类似这样:
第6步,在社区发布版本更新公告
在PhalApi开源社区,发布版本更新公告,参考:PhalApi 2.2.0 版本发布
在开源中国资讯栏目,发布本更新公告,参考:https://www.oschina.net/news/92221/phalapi-2-2-0" rel="nofollow" target="_blank">PhalApi 2.2.0 发布,PHP轻量级开源接口框架
在QQ交流群进行全员通知。
第7步,对官网首页和下载页进行版本更新
首先,更新PhalApi首页的版本号说明。
代码位置:https://gitee.com/dogstar/Phal ... .html
对应首页页面链接:https://www.phalapi.net/
其次,是下载页的新版本说明。
代码位置:https://gitee.com/dogstar/Phal ... .html
对应下载页的页面链接是:https://www.phalapi.net/download.html
后记
版本发布是一件很重要,倍受社区关注的事情,除了本身项目的代码质量要保持高质量外,还要求在发布过程中无差错,容不得半点马虎。
因此,这里将2.x版本发布的过程纪录如上,方便后续进行版本更新与维护时有清单参考。
同时,欢迎更多有兴趣的同学一起参与进来共同维护,一起开源!
PhalApi 1.x 旧版本发布流程回顾
http://qa.phalapi.net/?/article/50