罗罗编程学习记录
本页内容 展开查看

06.5.5.1 架构总览与启动流程

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf

06.5.5.1-001 Hyperf 是什么样的框架?技术底座是什么?

一句话结论

Hyperf 是基于 Swoole 或 OpenSwoole 协程扩展构建的常驻内存 PHP 框架,以 DI 容器、注解与 AOP 为核心,面向高性能协程服务与微服务场景;Swoole 提供进程、协程、网络通信底座,Hyperf 负责框架层编排。

概念解释

与传统 PHP-FPM 框架每个请求起一次进程、请求结束释放全部内存不同,Hyperf 以常驻内存方式运行,进程内同时服务大量协程。框架能力以 hyperf/* Composer 包形式按需引入,核心只保留容器、注解扫描、Server 启动等基础设施。

原理流程

  1. 业务代码通过 Composer 安装 hyperf/framework、hyperf/http-server、hyperf/di 等组件。
  2. 入口脚本创建容器与 Application,注册各组件的配置与启动回调。
  3. Swoole/OpenSwoole 监听端口,按回调把请求交给协程处理。
  4. 框架在协程内完成路由、中间件、控制器、响应的完整编排。

代码或图示

// composer.json require 段的典型形态(具体版本以 lock 文件为准)
// "php": ">=8.1"
// "hyperf/framework": "~3.2"
// "hyperf/http-server": "~3.2"

常见误区

  • 以为 Hyperf 自己实现了网络层:网络通信、进程管理由 Swoole/OpenSwoole 扩展提供,Hyperf 是上层框架。
  • 以为 Hyperf 只能做 HTTP 接口:同一进程内可同时挂载 HTTP、TCP、WebSocket、RPC 等多个 Server。

追问

  • Hyperf 支持哪些底层引擎?答:官方主线支持 Swoole,部分版本兼容 OpenSwoole;具体兼容矩阵以对应版本官方文档为准(待确认:核对 composer.json 的 ext-swoole/openswoole 约束)。
  • 常驻内存带来什么代价?答:进程生命周期内类与单例常驻,不能把请求态数据写进静态属性或单例属性,否则会跨请求串数据。

06.5.5.1-002 Hyperf 与 Laravel 这类 FPM 框架的运行模型有什么本质区别?

一句话结论

FPM 框架是“请求一次性生命周期”:每次请求重新引导框架、用完即释放;Hyperf 是“常驻内存 + 协程并发”:框架引导一次后长期驻留,靠协程调度在单进程内并发处理多个请求,状态管理必须按协程隔离。

概念解释

FPM 模式下进程随请求出生死亡,局部变量天然不跨请求;Hyperf 模式下对象、容器、单例长期存活,请求间共享进程内存,因此请求数据必须放进协程上下文(Context),不能挂在单例或静态变量上。

原理流程

  1. FPM:Nginx 转发请求 → 拉起 PHP-FPM 进程 → 引导框架 → 执行控制器 → 响应后销毁进程与内存。
  2. Hyperf:启动一次 → 容器与单例常驻 → 每个请求在独立协程内执行 → 协程结束只回收协程私有上下文,进程继续服务。
  3. 并发模型:FPM 靠多进程横向扩展;Hyperf 单进程内靠协程并发,配合 Worker 进程数水平扩展。

代码或图示

// 错误示范:把请求数据挂在单例控制器属性上,协程间会互相污染
class OrderController
{
    private int $userId = 0; // 禁止存放请求态数据

    public function info(): array
    {
        $this->userId = (int) request()->input('id');
        return ['uid' => $this->userId];
    }
}

常见误区

  • 把 FPM 时代“控制器属性存临时状态”的习惯搬到 Hyperf:单例属性会被后续协程覆盖。
  • 以为常驻内存等于不用考虑内存释放:协程私有数据仍需及时释放,大对象长期引用会造成常驻内存膨胀。

追问

  • 为什么 Hyperf 里控制器通常是单例?答:容器默认解析为单例以复用对象、降低创建开销;正因为单例复用,属性才不能存请求态数据。
  • 迁移 FPM 老代码最容易踩什么坑?答:全局变量、静态变量保存请求状态,以及在循环外持有请求相关连接对象;需要改为上下文传递与连接池获取。

06.5.5.1-003 Hyperf 骨架的目录结构与各目录职责是什么?

一句话结论

标准骨架按 app(业务代码)、config(配置)、bin(入口脚本)、runtime(运行期缓存与代理类)、vendor(依赖)划分;业务代码按 Controller、Service、Model、Aspect、Listener、Process 等目录组织。

概念解释

config/autoload/ 下的配置在启动时被加载并合并;runtime/ 存放扫描缓存与 AOP 代理类,属于生成物;bin/hyperf.php 是命令行与服务启动入口。目录约定服务于注解扫描:只有被扫描路径覆盖的类才会被收集注解并纳入容器管理。

原理流程

  1. bin/hyperf.php 引入 Composer 自动加载并引导 Application。
  2. 框架读取 config/autoload/ 下各组件配置。
  3. 扫描 app/ 等注册路径,收集类、注解与依赖关系。
  4. 生成代理类与元数据缓存到 runtime/,随后启动 Server。

代码或图示

// app/
// ├── Controller/      # HTTP 控制器
// ├── Service/         # 业务服务
// ├── Model/           # ORM 模型
// ├── Aspect/          # AOP 切面
// ├── Listener/        # 事件监听器
// └── JsonRpc/         # RPC 服务与消费者
// config/autoload/     # 自动加载配置
// bin/hyperf.php       # 入口脚本
// runtime/             # 扫描缓存与代理类(生成物)

常见误区

  • 把 runtime/ 当源码目录手工修改:它是构建产物,重新扫描或清缓存后会被覆盖。
  • 新建目录后注解不生效:新目录若未纳入扫描路径,类不会被容器收集。

追问

  • 扫描路径在哪里配置?答:在 config/autoload/annotations.php 的 scan.paths 中配置(待确认:3.x 字段名以对应版本官方文档为准)。
  • config/ 与 config/autoload/ 区别?答:autoload/ 下配置随框架自动加载;其他配置按组件或命令需要显式读取。

06.5.5.1-004 bin/hyperf.php 启动入口做了哪些事?

一句话结论

入口脚本定义基础路径、引入 Composer 自动加载、创建容器与 Application,注册配置与启动流程后调用 run() 启动 Server;它是命令行命令与常驻服务共用的引导点。

概念解释

入口本身很薄,真正的引导逻辑在框架组件的启动回调与监听器中。脚本既服务于 php bin/hyperf.php start 启动服务,也服务于自定义命令、消费者、定时任务等 CLI 场景。

原理流程

  1. 定义 BASE_PATH 等常量,引入 vendor/autoload.php。
  2. 加载环境变量与基础配置,构建 DI 容器。
  3. 把容器交给 Application,注册 Server 与各组件启动钩子。
  4. 调用 Application->run(),由 Swoole/OpenSwoole 进入事件循环。

代码或图示

// 骨架入口的简化形态;具体类名与参数以官方 skeleton 为准(待确认)
require_once BASE_PATH . '/vendor/autoload.php';

$container = require BASE_PATH . '/config/container.php';
$application = new \Hyperf\Server\Application($container);
$application->run();

常见误区

  • 在入口脚本里写业务初始化:应放到监听器、服务提供者或启动回调中,便于组件复用与测试。
  • 以为入口每次请求都执行一次:常驻模式下入口只在进程启动时执行一次。

追问

  • 命令行命令怎么复用这个入口?答:框架在同一引导流程内识别命令参数,注册到容器的命令通过 php bin/hyperf.php <命令名> 执行。
  • 容器在哪里构建?答:通常由 config/container.php 或框架内部工厂创建,入口只负责组装;具体实现版本间可能调整(待确认:核对当前 skeleton 的 config/container.php)。

06.5.5.1-005 Application 启动阶段的先后顺序是什么?

一句话结论

典型顺序为:加载环境与配置 → 构建容器 → 扫描注解与收集元数据 → 注册监听器/切面/路由等组件 → 启动 Server 并进入事件循环;请求级处理发生在启动完成之后。

概念解释

启动阶段完成“一次性准备工作”:依赖关系、代理类、路由表、监听器注册都在此阶段固化。请求阶段只做协程内的业务编排,不再重复扫描与构建容器,这是常驻框架启动后吞吐高的原因之一。

原理流程

  1. 读取 .env 与 config/autoload/ 配置,合并组件默认配置。
  2. 创建容器,注册配置绑定与依赖定义。
  3. 扫描类与注解,生成代理类、路由元数据、监听器列表。
  4. 触发启动类事件,各组件完成初始化(连接池预热等)。
  5. 启动 Swoole/OpenSwoole Server,注册回调并进入事件循环。

代码或图示

// 加载 env/config
// → 构建 DI 容器
// → 注解扫描与元数据收集
// → 注册监听器、切面、路由、消费者
// → 组件初始化与连接池预热
// → Server 启动,进入事件循环

常见误区

  • 在启动阶段读取请求数据:启动时还没有请求,请求态数据只能在协程处理阶段获取。
  • 把耗时初始化放到每个请求里:应在启动阶段或懒加载阶段完成,避免拖慢单请求。

追问

  • 哪些工作适合放在启动阶段?答:不可变配置解析、路由注册、监听器注册、连接池预热;可变的请求上下文不适合。
  • 启动慢怎么定位?答:先看注解扫描范围是否过大、切面是否过多、代理类缓存是否开启;再按组件初始化耗时拆分定位。

06.5.5.1-006 注解扫描与收集机制是怎么工作的?

一句话结论

框架在启动期扫描注册路径下的类文件,解析类、属性、方法上的注解(含 PHP 8 原生 Attributes 与 PHPDoc 注解写法),把元数据写入容器与对应注册表;扫描结果可缓存以加快二次启动。

概念解释

注解本身只是元数据,真正生效依赖框架在启动期收集它:路由注解进入路由表,#[Inject] 进入属性注入计划,#[Aspect] 进入切面注册表。扫描范围由配置控制,范围越大启动越慢。

原理流程

  1. 读取扫描路径配置,枚举路径下的 PHP 类文件。
  2. 解析类结构与注解,区分类注解、属性注解、方法注解。
  3. 按注解类型分发到对应处理器:路由、注入、切面、消费者等。
  4. 生成元数据缓存与 AOP 代理类,供运行期使用。

代码或图示

// 控制器上的路由注解在扫描期被收集进路由表
#[Controller(prefix: 'user')]
class UserController
{
    #[GetMapping(path: '{id:\d+}')]
    public function info(int $id): array
    {
        return ['id' => $id];
    }
}

常见误区

  • 以为注解在运行时动态解析:Hyperf 多数注解在启动扫描期定型,改了注解需重启或清缓存才生效。
  • 自定义注解不加注册/扫描路径:注解类本身也要被扫描到,处理器才能识别。

追问

  • 扫描缓存开关叫什么?答:与代理/元数据缓存相关的 scan_cacheable 配置项,位于主配置文件;默认行为与字段名以当前版本文档为准(待确认:核对 config/config.php)。
  • 生产环境如何加快启动?答:收窄扫描路径、开启扫描缓存、减少不必要切面,发布时在构建阶段预热缓存。

06.5.5.1-007 Hyperf 的进程模型是怎样的?

一句话结论

底层沿用 Swoole/OpenSwoole 的 Master-Manager-Worker 结构:Master 管理信号与端口,Manager 管理 Worker 进程,Worker 进程内通过协程并发处理请求;Task Worker 用于投递异步任务,进程模型细节由扩展提供,框架只做配置与回调挂载。

概念解释

框架层通过 config/autoload/server.php 配置 Worker 数量、回调与协议;真正的进程 fork、信号处理、协程调度由 Swoole 扩展完成。面试中只需说清角色分工与框架挂载点,不展开扩展内核实现。

原理流程

  1. Master 进程绑定端口,接收连接信号。
  2. Manager 拉起并监控 Worker 进程。
  3. 每个 Worker 内运行事件循环,请求到达后创建协程执行业务。
  4. 耗时任务可投递到 Task Worker 或独立消费者进程处理。

代码或图示

// server.php 中 Worker 数与回调配置的简化结构(键名以官方配置为准)
return [
    'settings' => [
        'worker_num' => 4,
    ],
    'callbacks' => [
        'onRequest' => [\Hyperf\HttpServer\Server::class, 'onRequest'],
    ],
];

常见误区

  • 把 Worker 数等同于 CPU 核数就够了:IO 密集型协程服务的 Worker 数还要结合阻塞类型、内存与下游承载力评估。
  • 在 Worker 进程间共享内存变量:进程间内存隔离,跨进程共享需借助 Redis、数据库或进程间通信组件。

追问

  • Task Worker 与协程异步任务区别?答:Task Worker 是独立进程,适合重 IO 或阻塞操作;协程并发仍在当前 Worker 内调度,开销更低。
  • 进程崩溃谁负责拉起?答:由 Swoole/OpenSwoole 的 Manager 机制管理;框架层面可配合进程监控与部署策略保障可用性。

06.5.5.1-008 Hyperf 与 Swoole 的依赖关系是什么?

一句话结论

Hyperf 依赖 Swoole/OpenSwoole 扩展提供协程、网络服务、进程与定时器能力;框架在其之上实现容器、注解、AOP、路由与各业务组件,业务代码面向 Hyperf API 编程,不直接操作扩展底层。

概念解释

协程化的 MySQL、Redis、HTTP 客户端由对应扩展 hook 或 Hyperf 协程客户端提供;框架把这些能力包装成连接池与组件。升级 Swoole 版本时需要对照 Hyperf 版本的兼容约束,避免底层行为变化导致问题。

原理流程

  1. 安装 Hyperf 组件时检查扩展版本约束。
  2. Server 启动时调用扩展 API 监听端口、注册回调。
  3. 请求处理中框架使用协程客户端访问下游,阻塞时让出协程。
  4. 扩展负责协程调度与 IO 就绪回调,框架负责业务编排。

代码或图示

// 框架代码面向容器与组件 API,业务层不直接 new Swoole\Server
use Hyperf\Di\Annotation\Inject;

class DemoService
{
    #[Inject]
    private \Hyperf\Redis\Redis $redis;
}

常见误区

  • 认为不装 Swoole 也能跑 Hyperf:常驻服务能力依赖扩展,缺少扩展时相关组件无法启动。
  • 业务代码直接耦合 Swoole 原生类:应优先使用 Hyperf 封装的组件与接口,便于替换底层引擎与测试。

追问

  • OpenSwoole 能否替代 Swoole?答:部分 Hyperf 版本兼容 OpenSwoole,兼容范围与 API 差异以官方文档为准(待确认:核对当前版本安装要求)。
  • 哪些能力是 Swoole 提供的?答:进程管理、协程调度、TCP/UDP/HTTP/WebSocket 服务、定时器、异步任务、连接钩子;框架提供的是上层封装。

06.5.5.1-009 config 目录与环境变量是如何加载的?

一句话结论

config/autoload/ 下的 PHP 文件返回配置数组,启动时按组件名合并进配置仓库;环境变量通过 env() 读取 .env,敏感与环境相关的值不写死在配置文件里。

概念解释

配置在启动期加载为不可变为主的仓库,运行期读取用 config('key') 或 #[Value] 注入;需要动态刷新的配置由配置中心组件另行处理。.env 只在本地/容器注入环境变量,不提交真实密钥。

原理流程

  1. 加载 .env 到进程环境变量(生产也可由容器注入)。
  2. 读取 config/autoload/*.php,文件内用 env() 读取环境变量并给出默认值。
  3. 框架合并各组件默认配置与项目配置,写入配置仓库。
  4. 业务代码通过配置门面、助手函数或注解读取。

代码或图示

// config/autoload/databases.php 片段:环境变量驱动连接参数
return [
    'default' => [
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => (int) env('DB_PORT', 3306),
        'database' => env('DB_DATABASE', 'hyperf'),
    ],
];

常见误区

  • 在业务代码里直接读 getenv() 而不经配置层:绕过配置合并与默认值约定,环境差异难排查。
  • 把生产密钥写进 .env 并提交仓库:密钥应通过部署环境注入,仓库只保留示例。

追问

  • 运行期能改配置吗?答:基础配置以启动期加载为准;动态配置需接入配置中心组件并配合监听刷新,普通数组修改不会自动生效。
  • #[Value] 注解怎么用?答:属性上标注 #[Value('key')] 注入对应配置值,命名空间为 Hyperf\Config\Annotation\Value(待确认:3.x 写法以文档为准)。

06.5.5.1-010 Hyperf 的组件化设计体现在哪里?

一句话结论

框架核心保持精简,数据库、Redis、RPC、队列、定时任务、事件等能力均以独立 Composer 包提供,按 composer require 引入并在配置中启用;组件通过容器与事件机制接入主干,可插拔替换。

概念解释

组件之间面向接口协作:业务依赖抽象接口,容器绑定具体实现。这使得单个组件可以升级、替换或在测试中 mock,而不影响框架主干。骨架默认只带最小依赖,按需扩容。

原理流程

  1. 通过 Composer 安装对应 hyperf/xxx 组件包。
  2. 组件自带配置发布或默认配置,启动时被扫描注册。
  3. 组件把服务、监听器、注解处理器绑定进容器。
  4. 业务代码注入接口或组件类使用能力。

代码或图示

// # 按需引入组件;未引入的组件不会进入容器
// composer require hyperf/db-connection
// composer require hyperf/redis
// composer require hyperf/json-rpc

常见误区

  • 一次性装全量组件:增大启动扫描面与内存占用,未使用的能力也会参与初始化。
  • 组件之间直接依赖具体实现类:应依赖接口,便于替换与测试。

追问

  • 如何自定义一个可插拔组件?答:提供配置文件、服务绑定与监听器/注解处理器,通过容器注册;业务侧面向接口使用。
  • 组件升级要注意什么?答:对照组件 CHANGELOG 检查配置键、注解命名空间与接口签名变化,在测试环境验证后再发布。

06.5.5.1-011 单次 HTTP 请求在 Hyperf 中的流转阶段是什么?

一句话结论

请求到达后框架为其创建协程,依次经过全局中间件 → 路由匹配 → 路由/方法级中间件 → 控制器 → 响应对象返回,响应再经中间件逆向走出;异常由异常处理器统一接管。

概念解释

整条链路运行在请求所属协程内,请求与响应对象存入协程上下文,供中间件、控制器、日志等共享。与 FPM 流程类似,但状态隔离靠 Context 而非进程生命周期。

原理流程

  1. Server onRequest 回调接收 PSR-7 请求对象,写入上下文。
  2. 执行全局中间件管道,再匹配路由。
  3. 执行路由中间件,解析参数后调用控制器方法。
  4. 控制器返回结果,由响应组件包装为响应对象。
  5. 响应沿中间件链逆向返回,异常进入异常处理器生成错误响应。

代码或图示

// onRequest 回调
// → 全局中间件(洋葱外层)
// → 路由匹配
// → 路由中间件(洋葱内层)
// → 控制器
// → 响应包装
// → 中间件后置逻辑
// → 写回客户端

常见误区

  • 以为控制器返回数组就是最终响应:还需经过响应编码与中间件处理。
  • 在中间件之外另存请求对象:请求对象统一从上下文/请求接口获取,避免持有过期引用。

追问

  • 中间件短路怎么实现?答:中间件直接返回响应对象,不再调用 $handler->handle($request),后续链路不再执行。
  • 异常在哪一层兜底?答:注册的异常处理器接管未捕获异常,中间件内抛出的异常同样进入异常处理流程。

06.5.5.1-012 启动阶段有哪些扩展点可以挂载初始化逻辑?

一句话结论

常用扩展点包括事件监听器(监听启动类事件)、自定义命令、服务提供者式绑定与组件启动回调;需要在框架就绪后执行的一次性逻辑,应挂到启动事件而非控制器或构造函数里。

概念解释

构造函数只负责对象依赖装配,不适合做 IO 初始化;监听器在对应事件触发时执行,可拿到容器与上下文。连接池预热、缓存加载、注册中心上报等一次性动作都属于启动期扩展点。

原理流程

  1. 定义监听器实现 ListenerInterface,声明监听的事件类。
  2. 监听器在启动扫描期注册到事件分发器。
  3. 框架触发启动事件时回调监听器 process()。
  4. 在回调内从容器获取依赖并完成初始化。

代码或图示

use Hyperf\Event\Contract\ListenerInterface;

class BootListener implements ListenerInterface
{
    public function listen(): array
    {
        return [\Hyperf\Framework\Event\OnBootstrap::class];
    }

    public function process(object $event): void
    {
        // 启动期一次性初始化逻辑
    }
}

常见误区

  • 在服务类构造函数里发起网络请求:构造函数被容器解析时可能早于组件就绪,且单例只构造一次。
  • 把请求级初始化写进启动监听器:监听器运行时没有请求上下文。

追问

  • 启动事件类名以什么为准?答:监听的事件类命名空间在不同版本可能调整(待确认:核对当前版本 Hyperf\Framework\Event 下的事件类)。
  • 多个监听器顺序如何控制?答:按事件分发器注册顺序执行,必要时通过监听器配置或优先级调整(具体机制待确认)。

06.5.5.1-013 为什么常驻模型下每个请求要分配独立协程?

一句话结论

协程把阻塞 IO 转化为让出调度,使单 Worker 进程可并发挂起大量请求;每个请求独立协程栈与上下文,保证请求间状态隔离,这是常驻内存高并发的基础。

概念解释

如果一个请求全程占住进程等待 IO,同进程其他请求无法处理;协程在 IO 等待时挂起并切换到其他协程,IO 就绪后恢复。请求私有数据存在协程上下文,协程结束即回收,避免跨请求污染。

原理流程

  1. 请求到达 Worker 事件循环,框架创建处理协程。
  2. 业务执行中遇到协程化 IO(DB、Redis、HTTP),当前协程挂起等待。
  3. 调度器切换到其他就绪协程执行。
  4. IO 就绪后恢复原协程,完成响应并回收协程上下文。

代码或图示

// 并发等待多个下游结果时,协程挂起不会阻塞 Worker 内其他请求
$results = parallel_call(function () {
    return $this->userService->getProfile($id);
}, function () use ($id) {
    return $this->orderService->listByUser($id);
});

常见误区

  • 使用了非协程化的阻塞扩展/函数:阻塞调用会卡住整个 Worker,协程并发失效。
  • 在协程间共享可变数组或对象:协程切换时机不确定,共享可变状态需要加锁或改为上下文隔离。

追问

  • 怎么判断一个扩展调用是否协程安全?答:确认底层使用 Swoole/OpenSwoole 协程客户端或已 hook 阻塞函数;普通同步扩展调用在常驻服务中要谨慎。
  • 协程数上限受什么影响?答:单协程栈内存、进程内存与下游承载能力;需要按压测结果控制并发度。

06.5.5.1-014 开发与启动服务的命令有哪些?

一句话结论

常用入口是 php bin/hyperf.php start 启动常驻服务;开发期可配合文件监听工具自动重启,自定义命令通过同一入口执行;查看命令列表与帮助可使用框架命令行参数。

概念解释

框架命令行基于 Symfony Console 风格实现,命令类通过注解或配置注册。开发期代码改动后,注解扫描与代理类需要重新生成,因此需要重启进程或开启监听重启。

原理流程

  1. 执行 php bin/hyperf.php start,入口引导容器并启动 Server。
  2. 开发模式下文件监听工具检测到代码变更,重启 Worker 或整个进程。
  3. 其他命令经命令行路由到对应 Command 类执行。

代码或图示

// # 启动服务(在项目根目录执行)
// php bin/hyperf.php start

// # 查看可用命令(具体子命令以框架版本为准)
// php bin/hyperf.php list

常见误区

  • 改完代码不重启就验证新行为:常驻进程内类与代理仍是旧版本。
  • 在生产开发模式下开启文件监听:监听重启属于开发辅助,生产应靠发布流程滚动重启。

追问

  • 热更新方案有哪些?答:开发期可用进程级 watch 重启;生产不建议自动监听改代码,应通过部署版本发布滚动重启。
  • 命令类如何注册?答:实现命令基类并通过 #[Command] 注解或命令配置注册(命名空间以当前版本为准,待确认)。

06.5.5.1-015 扫描缓存与代理缓存在启动中起什么作用?

一句话结论

扫描缓存保存注解与依赖元数据,代理缓存保存生成的 AOP 代理类;开启后二次启动跳过重复解析与代码生成,加快启动速度;代码变更后需清理或重建缓存。

概念解释

首次启动需要扫描类文件、解析注解、生成代理类,开销较大;缓存命中后直接复用 runtime/ 下产物。生产发布时若不预热缓存,首个批次请求会承受冷启动开销。

原理流程

  1. 启动期检查缓存是否存在且与代码一致。
  2. 缓存有效:直接加载元数据与代理类。
  3. 缓存缺失或失效:重新扫描、解析、生成产物写回 runtime/。
  4. 代码变更后旧缓存可能与新代码不匹配,需清理重建。

代码或图示

// runtime/container/proxy/   # AOP 代理类缓存
// runtime/                   # 其他扫描元数据缓存

常见误区

  • 清缓存只删 runtime/ 下部分文件:应按框架提供的清理方式整体重建,避免残留旧代理类。
  • 生产关闭缓存靠每次启动实时扫描:高并发发布场景启动慢,应在构建或首次启动阶段预热。

追问

  • 代理类不更新会出现什么现象?答:新方法/新注入未生效,或报类方法不存在、属性未初始化等错误,清理代理缓存重启可复现验证。
  • 缓存一致性由什么保证?答:扫描缓存通常结合文件改动时间或缓存开关判断;具体判定机制以版本实现为准(待确认:核对 runtime/ 缓存结构)。

06.5.5.1-016 一个进程内可以挂载多个 Server 吗?

一句话结论

可以。config/autoload/server.php 支持配置多个 Server 节点,分别绑定不同端口与协议(HTTP、TCP、WebSocket、JSON-RPC 等),由同一组 Worker 进程按回调分发处理。

概念解释

多 Server 共用进程与容器,节省部署实例;不同协议的请求进入对应 Server 回调,路由与中间件按 Server 名隔离。RPC 服务与 HTTP 管理接口可共存于同一进程。

原理流程

  1. 在 Server 配置中声明多个服务节点,各自指定 host、port、协议与回调。
  2. 启动时扩展按配置监听多个端口。
  3. 请求到达后按端口与协议路由到对应 Server 处理器。
  4. 业务代码通过 Server 名区分中间件、路由与连接配置。

代码或图示

// 多 Server 配置的简化结构;节点键名与回调类以官方配置为准(待确认)
return [
    'servers' => [
        ['name' => 'http', 'type' => \Hyperf\Server\ServerInterface::SERVER_HTTP, 'port' => 9501],
        ['name' => 'jsonrpc', 'type' => \Hyperf\Server\ServerInterface::SERVER_TCP, 'port' => 9502],
    ],
];

常见误区

  • 多个 Server 共用一套路由与中间件:不同 Server 名有独立的中间件注册与路由命名空间。
  • 以为多 Server 必须多进程部署:同一进程内即可监听多端口,进程级扩展再按需拆分。

追问

  • RPC 服务怎么挂到独立 Server?答:#[RpcService] 的 server 属性指定挂载的 Server 名,与 services.php 消费者配置对应。
  • 端口冲突如何排查?答:先确认各 Server 配置端口未被占用,再检查防火墙与部署映射。

06.5.5.1-017 启动期异常与请求期异常分别在哪里处理?

一句话结论

启动期异常导致进程无法启动,直接输出到控制台并中断引导;请求期未捕获异常由注册的异常处理器按 Server 生成错误响应,二者处理路径不同。

概念解释

启动期还没有请求上下文,异常无法走 HTTP 响应流程,只能通过日志与控制台暴露;请求期异常在协程内被异常处理器接管,可按协议格式返回错误码与报文。

原理流程

  1. 启动阶段:配置错误、依赖解析失败、扫描异常直接抛出,进程退出。
  2. 请求阶段:业务抛出异常,中间件链不处理时进入异常处理器栈。
  3. 异常处理器匹配类型,构造响应对象并记录日志。
  4. 未被任何处理器匹配的异常走默认错误响应。

代码或图示

// 异常处理器需实现的接口形态(方法签名以当前版本为准,待确认)
interface ExceptionHandlerInterface
{
    public function handle(Throwable $throwable, ResponseInterface $response): ResponseInterface;
    public function isValid(Throwable $throwable): bool;
}

常见误区

  • 把启动配置问题当成请求 bug 排查:先看启动日志与控制台输出,确认进程是否正常起来。
  • 在异常处理器里再次抛出新异常:处理器应避免未捕获递归,异常记录与响应构造要兜底。

追问

  • 异常处理器在哪里注册?答:config/autoload/exceptions.php 按 Server 名登记处理器列表;执行顺序按注册顺序。
  • 启动期如何打印详细错误?答:查看控制台输出与框架日志文件,必要时临时开启调试模式;生产日志级别按规范配置。

06.5.5.1-018 常驻内存模型下有哪些内存与状态注意事项?

一句话结论

进程长期存活意味着单例、静态变量、缓存对象常驻内存;请求态数据必须放协程上下文,长生命周期对象要控制引用与体积,避免内存持续增长与跨请求污染。

概念解释

FPM 请求结束后内存释放,常驻模型不会自动回收业务持有的大对象。单例属性、静态数组、全局缓存若不断累积引用,会造成内存缓慢上涨;请求数据误入单例还会串号。

原理流程

  1. 区分生命周期:进程级(配置、连接池、单例服务)与协程级(请求、用户态、临时结果)。
  2. 协程级数据写入 Context,随协程结束回收。
  3. 进程级缓存设置上限与淘汰策略,避免无界增长。
  4. 定期观测进程内存曲线,定位长期持有的大对象。

代码或图示

// 禁止:单例服务属性累积请求数据
class ReportService
{
    private array $rows = []; // 会在常驻进程内持续累积

    public function add(array $row): void
    {
        $this->rows[] = $row;
    }
}

常见误区

  • 用静态数组做请求内临时累加:静态数据跨协程共享,必须改为局部变量或上下文存储。
  • 把大结果集长期挂在单例缓存:应分批处理并设置 TTL/容量上限。

追问

  • 内存上涨怎么排查?答:对比进程内存曲线,定位常驻集合;可用内存快照与对象引用分析手段(具体工具与扩展支持待确认)。
  • 单例里能存什么?答:无状态服务、不可变配置、连接池引用;可变请求状态不允许存。

06.5.5.1-019 Hyperf 版本与 PHP、Swoole 版本如何对应?

一句话结论

Hyperf 大版本对 PHP 版本与 Swoole/OpenSwoole 版本有明确约束,需以对应版本 composer.json 的 require 段与官方升级指南为准;面试与落地前应核对实际安装版本,不凭记忆写版本号。

概念解释

框架版本演进会跟随 PHP 新语法与扩展 API 调整,跨大版本升级需要对照 Breaking Changes。环境准备阶段先确认 PHP CLI 版本、扩展版本与框架约束三者匹配,再安装依赖。

原理流程

  1. 查看目标 Hyperf 版本的 composer.json,确认 PHP 下限与扩展约束。
  2. 用 php -v 与 php --ri swoole 核对本机环境。
  3. 安装依赖后启动验证,观察启动日志与组件兼容性提示。
  4. 跨版本升级时按官方升级指南逐项检查配置与接口变更。

代码或图示

// php -v
// php --ri swoole
// composer show hyperf/framework

常见误区

  • 凭印象填写“Hyperf 3.x 要求 PHP 8.0”等精确版本:版本下限随小版本调整,必须以仓库约束为准。
  • 只看 PHP 版本忽略扩展版本:扩展 API 不匹配会导致启动失败或协程化异常。

追问

  • 本机如何确认已装扩展?答:php --ri swoole 或 php --ri openswoole 查看扩展版本与编译参数;未安装时对应组件无法运行。
  • 版本冲突时优先看什么?答:先看 Composer 依赖解析报告,再对照框架官方文档的环境要求章节。

06.5.5.1-020 什么场景适合选 Hyperf,什么场景更适合 FPM 框架?

一句话结论

高并发 IO 密集、长驻服务、微服务 RPC、异步消费者等场景适合 Hyperf;传统后台管理、低并发、快速迭代且团队不熟悉协程模型的项目,FPM 框架在部署与排障上更省心。

概念解释

选型核心是并发模型与团队成本:Hyperf 发挥协程与常驻内存优势,但要求开发者理解上下文隔离、连接池与协程安全;FPM 模型简单、部署成熟,但单机并发受进程模型限制。

原理流程

  1. 评估并发量、IO 类型(DB/Redis/HTTP/消息)与响应延迟目标。
  2. 评估团队对协程、常驻内存、连接池的掌握程度。
  3. 评估部署环境:常驻进程管理、监控、滚动重启能力是否齐备。
  4. 按场景拆分:高并发接口与消费者走协程服务,低并发后台可沿用 FPM 方案。

代码或图示

// 高并发 IO 密集 / RPC / 队列消费 / 定时任务  → Hyperf 协程常驻
// 低并发后台 / 传统页面 / 快速交付 / 团队无协程经验 → FPM 框架

常见误区

  • 只按“性能高”选 Hyperf:常驻模型带来的状态管理、部署运维成本同样要计入。
  • 把阻塞型 CPU 密集计算塞进协程服务:CPU 密集任务应独立部署,避免拖垮 IO 协程调度。

追问

  • Hyperf 能同时提供 Web 后台与 API 吗?答:可以在同一框架内组织,但需按路由与中间件分层;后台页面型低并发场景并非其相对优势所在。
  • 选型后如何降低迁移风险?答:先抽象业务服务层,按接口替换框架实现;新功能试点协程组件,老模块逐步迁移。