【精华】PhalApi 2.x 新版本发布流程（欢迎来开源！）

当前，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