大师网-带你快速走向大师之路 解决你在学习过程中的疑惑,带你快速进入大师之门。节省时间,提升效率

【精华】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

版本说明与前面的更新日志保持一致。到这一步,其他开发人员进行: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