# 升级指南

因为框架在随着需求以及 Bug 在不断更新,所以在未来框架会发布新版本。为了方便从旧版本安装并使用框架的开发者无损更新到新版本,这里提供了升级版本上需要注意的事项。

# 版本约定

炸毛框架的版本号一般情况均按照 Semantic Versioning 2.0.0 (opens new window) 标准进行滚动发行,规则简述如下:

假设版本号为 x.y.z:

  • x 为大版本,一般只有在发生完全无法兼容的更新时增加,需要开发者最重视。
  • y 为小发行版本,默认情况下会新增组件功能,但会尽可能兼容旧版本,存在不兼容情况极少。
  • z 为补丁版本,在不进行任何大功能更新情况下提供 Bug 的修复,完全兼容前版本。

例如,炸毛框架的 2.4.2 版本,在 2.5.0 发行后,框架提供了大量新组件,但是对旧版本的配置和组件完全兼容,无任何额外的说明,则可以直接升级。

# 升级方法

根据安装方法不同,升级的方法也不同。

框架安装方式有多种,但主要分为三类:

  • Composer 加载库的方式
  • 框架源码模式
  • Phar 打包模式

在 Composer 加载库的方式下,一般是指使用命令 composer require zhamao/frameworkcomposer create-project zhamao/framework-starter 的方式安装框架,框架的核心文件都在 vendor 目录下。

此方式安装的框架升级最方便,直接执行命令 composer update 即可。

框架源码模式安装一般为直接使用 git clone 框架本体的 GitHub 仓库或下载 master 分支安装,这种情况不可升级版本(或使用 git pull 拉取)。

Phar 打包模式更新则必须重新自行打包新版本,例如从 Composer 加载库方式打包的框架,则需在原目录使用 composer update 后再次打包一个新版本。

# 升级提示

如果在升级过程中遇到了提示,则可能是需要升级某些配置文件需要手动进行合并更新。如果提示了更新,建议到 vendor/zhamao/framework/config/global.php 框架的最新库内配置文件与 config/global.php 文件进行对比。