3.0 升级指南

  • 3.0 版本主要修改了 PHP 最低版本为 8.0
  • 框架移除了 Doctrine Annotations，改成使用 PHP8 Attributes
  • 框架增加了大量的成员变量类型限制

转化所有注解

注意: 这个步骤只能在 2.2 版本下执行

以下脚本会将所有 Doctrine Annotations 转化为 PHP8 Attributes。

  1. composer require hyperf/code-generator
  2. php bin/hyperf.php code:generate -D app

修改 Hyperf 组件版本

直接将 composer.json 中的 hyperf/* 统一修改为 3.0.* 即可。

hyperf/engine 不跟随框架版本号，故不需要修改

后面只需要执行 composer update -o，就可以正常完成升级了。

升级模型

因为模型基类增加了成员变量的类型支持，所以需要使用以下脚本，将其升级为新版本。

  1. composer require hyperf/code-generator
  2. php vendor/bin/regenerate-models.php $PWD/app/Model

启动服务

接下来只需要启动服务，就可以看到不适配的地方，逐一修改即可。

  • AMQP Consumer 和 Producer
  • Listener 监听器