【精华】PhalApi 开源框架如何发布一个新版本?(欢迎来开源!)

当前,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
QQ截图20181202163719.jpg

 
版本说明与前面的更新日志保持一致。到这一步,其他开发人员进行: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的保持一致,避免混淆。更新内容也一样。
QQ截图20181202163925.jpg

 
到这一步,使用PhalApi的新开发人员,就能享受到最新版本的使用了。
 
第4步,对官方的在线示例进行升级
在服务器上,进行composer update,将在线示例demo升级到最新版本。
在线示例地址:http://demo.phalapi.net/docs.php
QQ截图20181201145842.jpg

 
 
第5步,对旧版本进行更新通知
代码位置:https://gitee.com/dogstar/Phal ... n.php
更新2.x 系列的版本号,通知旧版本的开发人员进行版本升级。
// 两个系列版本
$lastestVersion = substr($version, 0, 1) == '1' ? '1.4.1' : '
2.4.0';



效果类似这样:

 
第6步,在社区发布版本更新公告


QQ截图20181202164941.jpg

 
第7步,对官网首页和下载页进行版本更新
首先,更新PhalApi首页的版本号说明。
代码位置:https://gitee.com/dogstar/Phal ... .html
QQ截图20181202165124.jpg

对应首页页面链接:https://www.phalapi.net/
 
其次,是下载页的新版本说明。
代码位置:https://gitee.com/dogstar/Phal ... .html
对应下载页的页面链接是:https://www.phalapi.net/download.html
QQ截图20181202165241.jpg


后记
版本发布是一件很重要,倍受社区关注的事情,除了本身项目的代码质量要保持高质量外,还要求在发布过程中无差错,容不得半点马虎。
因此,这里将2.x版本发布的过程纪录如上,方便后续进行版本更新与维护时有清单参考。
同时,欢迎更多有兴趣的同学一起参与进来共同维护,一起开源!

PhalApi 1.x 旧版本发布流程回顾
http://qa.phalapi.net/?/article/50
 
 
 

0 个评论

要回复文章请先登录注册