mirror of
https://gitee.com/hyperf/hyperf.git
synced 2024-12-11 09:23:16 +08:00
1.7 KiB
1.7 KiB
版本説明
版本規則
Hyperf 採用 x.y.z 的版本號規則來命名各個版本,如 1.2.3 版本,1 即為 x,2 即為 y,3 即為 z,您可以根據該版本規則來制定您對 Hyperf 框架的更新計劃。
- x 表示一個重大版本,當 Hyperf 的核心進行大量的重構變動時,或當存在大量的破壞性 API 變更時,會作為一個 x 版本發佈,x 版本變更通常來説是無法與之前的 x 版本兼容,但也不一定代表完全無法兼容,具體根據對應版本的升級指南來進行甄別。
- y 表示一個主要功能迭代版本,當一些公開的 API 進行了破壞性的變更後,包括公開 API 的變更和刪除,導致前置版本可能無法兼容的時候,會以 y 版本來進行發佈。
- z 表示一個完全兼容的修復版本,當對各個組件的已有功能進行 BUG 修復或安全修復時,會選擇以一個 z 版本來發布,當一個 BUG 導致了某個功能完全無法使用時,亦可能在 z 版本內修復這個 BUG 時對 API 進行破壞性變更,但由於功能此前已經完全無法使用故此類變更不會以 y 版本來發布,除了 BUG 修復,z 版本也可能會包括一些新增的功能或組件,這些功能和組件均不會影響此前的代碼使用。
升級版本
當您希望升級 Hyperf 版本時,如果是對 x 和 y 版本的升級,請根據文檔內對應版本的升級指南來進行操作。如您希望對 z 版本進行升級,可直接在您的項目的根目錄執行 composer update hyperf
命令來對依賴包進行更新,我們不建議您單獨升級某一個組件的版本,而是統一升級所有組件來獲得更加一致的體驗。