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

06.5.6.2 协程 hook 与运行时隔离

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

06.5.6.2-001 什么是协程 hook,它解决什么问题?

一句话结论

协程 hook 是运行时对 PHP 标准库与扩展阻塞函数做的一层替换:被 hook 的函数在阻塞等待时自动挂起当前协程,事件就绪后恢复,让既有阻塞风格代码也能在协程内并发运行。

概念解释

没有 hook 时,业务必须改用 Swoole 提供的协程客户端才能获得并发;hook 在底层拦截 socket、sleep、文件流、curl 等调用,把阻塞等待转换为协程挂起点。这样传统写法的 file_get_contents、sleep、mysqli 等在被覆盖范围内也能让出执行权。hook 覆盖边界随版本变化,未被覆盖的调用仍会阻塞整个 Worker。

原理流程

  1. 运行时在初始化阶段按 flags 注册被 hook 的函数入口。
  2. 协程内调用被 hook 函数时,进入扩展替换后的实现。
  3. 需要等待 IO/时间时挂起当前协程,让出 Worker。
  4. 事件就绪后恢复协程,函数按原语义返回结果。

代码或图示

use Swoole\Runtime;

// 开启协程 hook;flags 取值见后续题目,具体常量全集以官方文档为准
Runtime::enableCoroutine(SWOOLE_HOOK_ALL);

常见误区

  • 以为 hook 后所有阻塞函数都变协程安全:只覆盖 flags 指定的类别,未覆盖的原生阻塞调用仍卡住进程。
  • 以为 hook 会修改业务代码:hook 在运行时层替换调用入口,源码写法不变。

追问

  • hook 在什么时候开启?答:应在创建协程与发起 IO 之前调用;进入请求回调后再开启可能漏掉早期调用,具体时机约束待确认。
  • 如何查看本机已 hook 的类别?答:php --ri swoole 输出与官方 hook 文档对照;flags 常量名与覆盖范围以版本为准。

06.5.6.2-002 Runtime::enableCoroutine 的调用位置与时机有什么要求?

一句话结论

Runtime::enableCoroutine() 需在业务协程与阻塞 IO 发生之前调用,通常放在脚本入口或服务启动引导阶段;调用过晚,之前已执行的阻塞路径不会被纳入 hook。

概念解释

hook 是运行时层的全局开关,作用于开启之后发生的函数调用。放在框架引导文件、Server 启动前或 onWorkerStart 早期均可,具体放哪一层取决于服务结构。开启后同一进程内后续协程调用都受 flags 约束;是否支持运行中关闭、重复调用的行为待确认。

原理流程

  1. 脚本入口先初始化运行时配置。
  2. 调用 Runtime::enableCoroutine($flags) 注册 hook 类别。
  3. 之后创建的协程与 IO 调用走 hook 后的实现。
  4. 服务启动进入事件循环,业务回调在 hook 生效环境中执行。

代码或图示

use Swoole\Runtime;

// 入口引导阶段开启,先于 Server 启动与协程创建
Runtime::enableCoroutine(SWOOLE_HOOK_ALL);

$server = new Swoole\HTTP\Server('0.0.0.0', 9501);

常见误区

  • 在某个请求回调里才开启 hook:同进程其他已运行协程与早期调用不受影响。
  • 反复开关 hook 而不核对版本行为:重复调用与关闭接口的语义需查文档,标注待确认。

追问

  • 能否按文件局部开启 hook?答:hook 是进程级运行时开关,不是文件级作用域;局部隔离需通过不调用对应阻塞函数实现。
  • 框架在哪里开启?答:框架通常在引导阶段统一调用;本章节只讨论扩展层,框架封装位置不展开。

06.5.6.2-003 hook flags 分为哪些类别?

一句话结论

flags 按 IO 类别分组,常见覆盖 TCP/UDP/Unix socket、sleep、文件流、Redis、MySQL/PDO、curl、进程等类别;具体常量名、编号与默认组合随版本不同,需对照官方文档与 php --ri swoole 核对。

概念解释

enableCoroutine 接收 flags 位掩码,可按类别组合开启。网络类 hook 覆盖 socket 读写与连接等待;sleep 类覆盖延时等待;文件/流类覆盖本地流操作;数据库与缓存类覆盖对应客户端阻塞调用。面试时应能说出分组思路,而不是背死常量表;不确定的常量名标注待确认。

原理流程

  1. 按业务使用的 IO 类别选择对应 flag。
  2. 位或组合多个 flag,或直接使用全量 flag。
  3. 运行时按 flags 注册对应函数的 hook 入口。
  4. 未选中类别的函数保持原生阻塞行为。

代码或图示

use Swoole\Runtime;

// 示例组合:网络 + sleep + curl;实际常量名以本机版本文档为准
$flags = SWOOLE_HOOK_TCP | SWOOLE_HOOK_SLEEP | SWOOLE_HOOK_CURL;
Runtime::enableCoroutine($flags);

常见误区

  • 把 flags 当成 Worker 数量配置:它是 hook 类别位掩码,与进程模型无关。
  • 假设所有版本常量名一致:旧版本与 5.x 的常量命名可能调整,需核对。

追问

  • SWOOLE_HOOK_ALL 包含哪些类别?答:全量组合,覆盖当前版本支持的全部 hook 类别;具体清单以官方文档为准,待确认。
  • 只开网络 flag 会怎样?答:sleep、文件流、curl 等类别仍原生阻塞,业务用到时会卡住 Worker。

06.5.6.2-004 全量 hook SWOOLE_HOOK_ALL 与按需组合有什么取舍?

一句话结论

全量 hook 覆盖最全、接入简单,但可能 hook 到不需要的类别带来兼容风险;按需组合缩小影响面,便于定位问题,但要逐项核对业务用到的 IO 类别不遗漏。

概念解释

全量开启适合快速接入与兼容既有代码;按需组合适合对稳定性要求高、能梳理清楚 IO 清单的项目。某些底层扩展或特殊流在全量 hook 下可能出现行为异常,此时先缩小 flags 复现定位。两种方式都不能覆盖未被实现 hook 的扩展函数。

原理流程

  1. 梳理业务使用的阻塞 IO:socket、sleep、文件、Redis、MySQL、curl 等。
  2. 评估全量开启的兼容性风险,决定全量还是组合。
  3. 压测关键路径,观察是否有挂起不恢复或返回值异常。
  4. 出问题时先裁剪 flags 定位具体类别。

代码或图示

use Swoole\Runtime;

// 按需组合示例:仅网络与 sleep
Runtime::enableCoroutine(SWOOLE_HOOK_TCP | SWOOLE_HOOK_SLEEP);

常见误区

  • 认为全量 hook 一定最优:覆盖面大也意味着兼容面大,异常定位更困难。
  • 漏配类别后误以为协程失效:某类 IO 未 hook 时表现为局部阻塞,而非整体不并发。

追问

  • 线上建议用哪种?答:新项目可先全量压测,稳定后按实际 IO 收敛;历史系统先梳理阻塞调用清单再决定,结论以压测结果为准。
  • hook 后出现异常返回值怎么办?答:核对该类别是否在 hook 覆盖内,查官方已知兼容问题,必要时裁剪对应 flag。

06.5.6.2-005 被 hook 的阻塞调用边界在哪里?

一句话结论

边界是运行时实现了替换入口的函数与客户端:标准库 socket/流/sleep/curl 等在 flags 覆盖内的调用走协程挂起;未被 hook 的 C 扩展函数、内部计算与非阻塞 API 不在边界内。

概念解释

判断边界看两层:一是 flags 是否选中该类别,二是扩展是否为该函数实现了协程化替换。被 hook 的调用在等待时挂起协程;边界外的阻塞调用直接占用 Worker。很多第三方 C 扩展没有协程版本,其内部锁等待或网络调用无法通过 hook 变成挂起点。

原理流程

  1. 调用发生时,运行时先检查该函数是否在 hook 表中。
  2. 命中且 flags 开启:走协程化实现,等待时挂起。
  3. 未命中:调用原生实现,阻塞当前 Worker。
  4. 排查阻塞问题时先确认目标函数是否在覆盖边界内。

代码或图示

use Swoole\Runtime;

Runtime::enableCoroutine(SWOOLE_HOOK_ALL);

go(function () {
    // 被 hook 的等待类调用:挂起当前协程
    Coroutine::sleep(0.01);
});

常见误区

  • 把“PHP 代码里的阻塞”等同于“被 hook 的阻塞”:hook 只覆盖特定函数,不覆盖任意第三方扩展。
  • 认为数据库驱动自动全部协程化:特定扩展/驱动是否覆盖需查文档,待确认。

追问

  • 如何确认某个函数是否被 hook?答:对照官方 hook 函数清单;本机可用最小复现脚本观察并发表现,php --ri swoole 核对版本。
  • 边界外阻塞怎么处理?答:换成 Swoole 协程客户端、投递异步任务进程,或评估该扩展是否提供协程版本。

06.5.6.2-006 未被 hook 的阻塞调用会造成什么后果?

一句话结论

未被 hook 的阻塞调用会卡住整个 Worker 进程:等待期间事件循环无法分发事件,同 Worker 的其他协程、新连接与定时器全部被拖延,表现为延迟飙升与连接堆积。

概念解释

协作式调度要求阻塞被转化为挂起点。原生阻塞系统调用或第三方扩展阻塞函数占住执行权,事件循环在同一线程内无法并行处理就绪事件。单个慢调用会拖累该 Worker 上所有协程,而不只是当前请求。多 Worker 部署下,问题集中在被卡住的 Worker 上。

原理流程

  1. 协程调用未被 hook 的阻塞函数。
  2. Worker 进入内核等待,执行权无法让出。
  3. 事件循环排队,其他就绪协程与连接事件得不到处理。
  4. 阻塞返回后,积压事件被集中处理,延迟出现尖刺。

代码或图示

go(function () {
    // 假设某第三方扩展调用未被 hook:会阻塞当前 Worker
    // $thirdParty->blockingWait();
    echo "this worker stalls until blocking call returns\n";
});

常见误区

  • 以为卡住只影响当前请求:同 Worker 所有协程共享执行权,阻塞是进程级影响。
  • 看到延迟高就加 Worker 数:根因可能是未 hook 阻塞,加 Worker 只能分摊不能消除。

追问

  • 如何快速定位未 hook 阻塞?答:对比单协程与并发下的耗时、按 Worker 观察延迟与挂起协程数,逐个排查第三方扩展调用点。
  • 系统调用层面如何确认?答:结合进程状态、调用栈与 strace 一类工具(Linux)观察阻塞点;工具可用性以本机环境为准。

06.5.6.2-007 Server 配置项 enable_coroutine 与 Runtime::enableCoroutine 有什么区别?

一句话结论

enable_coroutine 是 Server 级别设置,决定 Worker 回调是否运行在协程中;Runtime::enableCoroutine 是运行时 hook 开关,决定哪些阻塞函数被替换为协程挂起点。两者层次不同,需分别配置与核对默认值。

概念解释

Server 设置控制回调执行环境:开启后 onRequest、onReceive 等回调在独立协程内运行,具备协程 ID 与挂起能力。Runtime hook 控制函数行为:即使回调在协程内,未 hook 的阻塞调用仍会卡 Worker。默认取值与配置名称随版本变化,标注待确认,需以官方配置文档核对。

原理流程

  1. Server 启动读取 enable_coroutine 类配置,决定回调是否进入协程上下文。
  2. 回调执行前,Runtime 按已开启 flags 准备 hook 表。
  3. 协程内 IO 调用经 hook 挂起;配置关闭协程时回调占用 Worker 主线程。
  4. 两层共同决定请求能否并发与阻塞能否让出。

代码或图示

$server = new Swoole\HTTP\Server('0.0.0.0', 9501);

// Server 级协程开关,键名与默认值以官方配置文档为准
$server->set([
    'enable_coroutine' => true,
]);

常见误区

  • 把两个开关当成同一个东西:一个管回调是否在协程内,一个管函数是否被 hook。
  • 开启 hook 就以为回调一定在协程内:仍需确认 Server 协程开关与回调上下文。

追问

  • 关闭 enable_coroutine 会怎样?答:回调在 Worker 主线程顺序执行,阻塞调用直接占住进程;具体行为以版本文档为准,待确认。
  • 如何确认回调处于协程内?答:在回调中调用 Coroutine::getCid() 观察返回值,结合版本约定判断。

06.5.6.2-008 协程内的全局变量为什么会造成污染?

一句话结论

$GLOBALS 与进程级全局变量被同进程所有协程共享,请求间不清空,后到协程覆盖先到协程写入的值,导致串数据、状态错乱。

概念解释

FPM 每请求重置全局状态;常驻协程进程不重置,全局变量在 Worker 整个生命周期保留。A 协程把请求态写入全局变量,B 协程并发或随后读到残留值。全局变量既不是协程私有,也不随请求结束自动清理,是常驻模式下最典型的污染源之一。

原理流程

  1. 协程 A 在请求处理中写入 $GLOBALS['user']。
  2. 协程 A 挂起等待 IO,协程 B 被调度执行。
  3. 协程 B 读到 A 写入的残留值,或覆盖该变量。
  4. A 恢复后拿到被污染的状态,出现串用户/串订单问题。

代码或图示

// 反例:请求态写入全局变量,并发下互相覆盖
$GLOBALS['current_user'] = $userId;

// 正确做法:请求态用局部变量或协程上下文传递
$context = ['user_id' => $userId];

常见误区

  • 以为请求结束会清空全局变量:常驻进程不做 FPM 式重置,残留持续到进程重启。
  • 把全局变量当请求缓存:请求态数据必须走协程私有上下文或参数传递。

追问

  • 如何排查全局污染?答:搜索 $GLOBALS 写入点与全局可变数组,评审请求态是否进入全局;压测并发复现串数据。
  • 全局常量安全吗?答:不可变常量只读共享,风险低;可变全局数组、对象属性才是污染源。

06.5.6.2-009 静态变量与静态属性在协程间共享有什么风险?

一句话结论

函数静态变量与类静态属性属于进程共享存储,被同 Worker 所有协程读写;保存请求态时并发互相覆盖,残留上一次请求数据,与全局变量属于同一类污染。

概念解释

静态存储在进程生命周期内只保留一份,不随协程结束销毁。单例对象的静态实例、缓存式静态属性、函数内静态缓存都在协程间可见。请求态数据(当前用户、请求参数、链路 ID)放进静态存储,就会在并发下串号;只读配置与无状态缓存相对安全。

原理流程

  1. 代码把请求态写入静态属性或函数静态变量。
  2. 协程挂起后另一个协程读写同一静态存储。
  3. 原值被覆盖或残留。
  4. 恢复后的协程基于错误静态状态继续执行。

代码或图示

class SessionHolder
{
    public static ?array $current = null; // 反例:请求态存静态属性
}

// 修复:请求态作为方法参数传递,或存入协程私有上下文
function handle(array $context): void
{
    $user = $context['user'];
}

常见误区

  • 以为静态变量是“本次调用私有”:静态变量跨调用保留,常驻进程中跨协程共享。
  • 只清理出问题的那一个静态属性:同类静态缓存点需一并排查。

追问

  • 静态缓存能不能用?答:缓存只读派生数据可以,但不能保存可变请求态;缓存键需包含隔离维度,失效策略要明确。
  • 框架上下文如何替代静态存储?答:框架协程上下文按协程隔离存取请求态;本章节只引用框架能力,展开见框架层专题。

06.5.6.2-010 单例对象的成员属性保存请求态有什么风险?

一句话结论

单例在进程内只实例化一次,其成员属性被所有协程共享;把当前用户、请求体等请求态写进单例属性,并发下互相覆盖,出现与静态污染同类的串数据问题。

概念解释

单例常用于无状态工具、配置共享,其方法应只依赖参数与只读配置。如果把请求对象、用户信息、临时结果挂到单例属性上,属性就成了共享可变状态。协程挂起期间其他请求进入同一单例覆写属性,恢复后读到错误数据。判断标准:属性是否随请求变化。

原理流程

  1. 单例对象在 Worker 启动后创建并常驻。
  2. 协程 A 把请求数据写入单例属性。
  3. A 挂起,协程 B 覆写同一属性。
  4. A 恢复后使用被 B 修改的属性,产生错误结果。

代码或图示

class OrderService
{
    private array $payload = []; // 反例:成员属性保存请求态

    public function save(array $payload): void
    {
        $this->payload = $payload;
    }
}

// 修复:请求数据走方法参数,不在单例属性留存
public function persist(array $payload): void
{
    // 仅使用参数 $payload
}

常见误区

  • 以为单例天然线程/协程安全:单例只保证实例唯一,不保证属性并发安全。
  • 只检查静态属性,忽略单例成员属性:后者是常驻框架中更隐蔽的污染源。

追问

  • 单例里需要保存连接怎么办?答:连接属于长生命周期资源,应由连接池统一借还,不能在单例属性里固化某个请求的连接。
  • 如何建立检查清单?答:评审静态属性、单例可变属性、全局数组;请求态一律进上下文或参数传递。

06.5.6.2-011 协程上下文隔离与 hook 是什么关系?

一句话结论

hook 解决“阻塞调用能否挂起让出”,上下文隔离解决“请求态数据是否按协程私有”;两者相互独立,hook 生效不等于上下文自动隔离,共享变量污染仍需上下文规范与同步手段治理。

概念解释

hook 是运行时对函数阻塞行为的改造,不自动为每个协程隔离 PHP 全局与静态存储。上下文隔离由运行时私有存储或框架封装实现,保证请求态只在当前协程可见。即使全量 hook 开启,代码直接读写静态/全局变量仍会串数据;反过来,配好上下文也不能替代 hook 把阻塞调用变协程化。

原理流程

  1. Runtime 按 flags 把阻塞调用转为挂起点(hook 层)。
  2. 运行时/框架为每个协程维护私有上下文存储(隔离层)。
  3. 业务请求态写入私有上下文,不进入全局静态存储。
  4. 两层各自生效:并发让出靠 hook,数据不串靠隔离规范。

代码或图示

use Swoole\Coroutine;

// 协程私有存储接口名与方法以官方文档为准;此处仅示意隔离思路
// Coroutine::getContext() 类接口按版本核对,待确认
$context = Coroutine::getContext();
$context['trace_id'] = 'demo-trace';

常见误区

  • 以为开启协程后变量自动按协程隔离:PHP 全局/静态存储不自动隔离。
  • 把上下文当跨协程通信通道:上下文私有,跨协程通信要用 Channel 等原语。

追问

  • 子协程能访问父协程上下文吗?答:是否复制/继承取决于运行时与框架实现,不能默认继承;需要传递时显式传入。
  • 上下文丢失常见于什么场景?答:异步回调、派生协程、跨线程/进程边界;排查时确认上下文存取发生在哪个协程。

06.5.6.2-012 协程间直接复用数据库/Redis 连接对象有什么风险?

一句话结论

连接对象不是协程安全的共享资源:多协程并发在同一连接上收发请求会造成响应错乱;正确做法是经连接池借还,或每个协程持有独立连接。

概念解释

单连接一次只能处理一轮请求/响应。协程 A 发查询后挂起等待,协程 B 在同一连接上再发查询,返回报文就可能被错误匹配到 A 的请求。hook 让客户端等待可挂起,但不自动保证连接互斥。常驻服务中连接必须由池管理:借出独占使用,用完归还,避免交叉读写。

原理流程

  1. 协程 A 从共享连接发出查询,挂起等待响应。
  2. 协程 B 在同一连接发出另一查询。
  3. 响应报文到达时与请求对应关系错乱。
  4. A/B 拿到错误结果,出现脏数据或报文解析异常。

代码或图示

// 反例:把单个连接对象放在全局/单例里供多协程共用
// $redis->get('key'); // 并发交叉读写会错乱

// 思路:每次使用从连接池借出独立连接,用完归还
// 连接池具体组件属于框架/扩展客户端层,此处仅说明隔离要求

常见误区

  • 以为 hook 后的客户端天然协程安全:hook 解决阻塞挂起,不解决连接复用互斥。
  • 用单例缓存一个长连接给全进程共用:高并发下必然交叉读写。

追问

  • 连接池如何保证互斥?答:借出期间独占,归还前其他协程不可取;池耗尽时排队或报错,超时策略按配置。
  • 短连接可行吗?答:低并发场景可每协程新建连接,但握手开销大;高并发优先连接池。

06.5.6.2-013 hook 对标准库文件与流类函数有什么影响范围?

一句话结论

文件读写、流操作、sleep/usleep 等在对应 flag 覆盖内会被改造为协程挂起;但本地磁盘 IO 的挂起收益与实现方式随版本不同,未覆盖的流包装器仍可能阻塞,需逐项核对文档。

概念解释

hook 覆盖的标准库类别包括延时等待、socket 流、本地文件流等。被覆盖函数在等待时挂起协程;文件类 IO 是否走异步线程池、还是仍在进程内完成,取决于扩展实现与版本。本地磁盘读写通常不具备网络 IO 的并发收益,大文件处理应评估阻塞影响。具体覆盖函数清单标注待确认。

原理流程

  1. 业务调用 sleep、file_get_contents、流读写等函数。
  2. 命中对应 flag 的 hook 表则进入协程化实现。
  3. 等待期间挂起当前协程,事件就绪后恢复。
  4. 未命中时保持原生阻塞行为。

代码或图示

use Swoole\Runtime;

Runtime::enableCoroutine(SWOOLE_HOOK_FILE | SWOOLE_HOOK_SLEEP);

go(function () {
    Coroutine::sleep(0.001);
    $content = file_get_contents('demo.txt');
});

常见误区

  • 以为文件 IO 和网络 IO 并发收益相同:磁盘 IO 受本地设备与实现约束,不能照搬网络并发经验。
  • 在请求路径上做大文件同步读写:应考虑异步任务或流式分块处理。

追问

  • usleep/time_nanosleep 被覆盖吗?答:以官方 sleep 类 hook 清单为准,待确认;本机版本可用并发脚本验证挂起行为。
  • 流包装器(如 php://)受 hook 影响吗?答:取决于 hook 实现覆盖范围,需对照文档与实测,不要假设全部覆盖。

06.5.6.2-014 Curl 类调用在 hook 后行为有什么需要注意的?

一句话结论

curl 类 hook 把单句柄阻塞等待转为协程挂起;但 curl_multi、句柄复用、错误处理与返回值约定可能与原生行为有差异,需在目标版本实测并对照文档。

概念解释

普通 curl_exec 阻塞等待在 hook 覆盖内可挂起让出。多句柄并发场景原本使用 curl_multi_*,协程化后通常直接并发 go() 内各自执行单句柄调用。curl 句柄跨协程复用、超时与错误码行为需单独验证;SWOOLE_HOOK_CURL 与原生 curl hook 的具体实现差异标注待确认。

原理流程

  1. 开启 curl 对应 flag,注册 curl 相关 hook。
  2. 协程内执行 curl_exec,等待时挂起。
  3. 响应就绪后恢复,按原返回约定输出结果。
  4. 多请求并发用多个协程分别处理,替代 multi 句柄轮询。

代码或图示

use Swoole\Runtime;

Runtime::enableCoroutine(SWOOLE_HOOK_CURL);

go(function () {
    $ch = curl_init('https://example.com');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $body = curl_exec($ch);
    curl_close($ch);
});

常见误区

  • 以为 curl_multi 在协程下必须保留:协程并发已提供并发能力,单句柄 + 多协程是常见写法。
  • 忽略 curl 句柄关闭:句柄与 fd 不释放会累积资源占用。

追问

  • 代理、证书等 curl 选项受 hook 影响吗?答:选项透传行为以实现为准;异常场景需实测复现。
  • hook 后 curl_errno/curl_error 还可靠吗?答:错误返回约定需对照文档与实测,标注待确认。

06.5.6.2-015 运行中能否关闭或调整 hook?

一句话结论

是否提供关闭 hook 的运行时接口、重复调用 enableCoroutine 的合并/覆盖语义,随版本不同;在不确定前不要在业务路径上动态开关,相关接口名与行为标注待确认并核对官方文档。

概念解释

多数常驻服务在启动引导阶段一次性设定 hook flags,运行中不再调整。动态关闭可能影响已创建协程与已注册客户端,行为边界复杂。需要隔离某段不希望 hook 的代码时,优先通过改用独立进程、避免对应阻塞调用等方式处理,而不是依赖运行时开关。

原理流程

  1. 启动阶段确定 hook 类别并一次性开启。
  2. 运行期间保持 flags 不变。
  3. 若版本提供调整接口,先在测试环境验证对已运行协程的影响。
  4. 不确定的接口标注待确认,不写入生产路径。

代码或图示

use Swoole\Runtime;

// 仅在入口一次性设置;是否存在 disableCoroutine 类接口以版本文档为准
Runtime::enableCoroutine(SWOOLE_HOOK_ALL);

常见误区

  • 在请求回调里反复开关 hook 试图隔离问题:行为不可靠,且可能影响其他协程。
  • 凭旧版本记忆调用关闭接口:接口名与语义需在目标版本核对。

追问

  • 如何验证某版本是否支持关闭?答:查官方文档运行时接口列表,php --ri swoole 核对版本;最小脚本验证调用后的行为。
  • 隔离需求还有什么替代方案?答:把不兼容 hook 的逻辑放进独立自定义进程或 Task Worker,与主服务隔离。

06.5.6.2-016 在协程内使用未协程化的第三方 C 扩展会怎样?

一句话结论

未提供协程版本、也未被 hook 覆盖的 C 扩展,其阻塞调用与内部锁等待会卡住 Worker;协程上下文无法接管其内部等待,只能换协程客户端、隔离进程或避免使用。

概念解释

hook 只能替换运行时实现覆盖到的函数;第三方扩展内部的系统调用、互斥锁等待、网络请求不在替换范围内。扩展内部一旦阻塞,整个 Worker 被占住。常见风险点包括未协程化的数据库驱动、消息队列客户端、加锁的本地库。选型时要确认扩展是否兼容协程环境。

原理流程

  1. 协程调用第三方扩展方法。
  2. 扩展内部执行阻塞等待或获取内部锁。
  3. 等待点不在 hook 表内,无法挂起协程。
  4. Worker 被卡住,同进程其他协程排队等待。

代码或图示

go(function () {
    // 假设 $legacy 为未协程化扩展:其阻塞调用无法被 hook 接管
    // $legacy->fetchBlocking();
    echo "worker stalls inside legacy extension call\n";
});

常见误区

  • 认为只要跑在 go() 里,调用任何扩展都是协程安全的:安全边界在扩展实现,不在外层协程。
  • 线上才发现扩展阻塞:选型阶段就应核对协程兼容性与已知问题。

追问

  • 如何确认扩展是否协程安全?答:查官方/社区兼容说明,并发压测观察 Worker 阻塞与延迟;必要时看扩展源码是否使用 hook 兼容接口。
  • 必须用该扩展怎么办?答:放到独立自定义进程或 Task Worker 运行,经队列/通道与主服务交互,隔离阻塞影响。

06.5.6.2-017 子协程如何继承父协程的变量与上下文?

一句话结论

PHP 变量按闭包捕获规则在协程间传递;协程私有上下文是否被子协程复制取决于运行时/框架实现,不能默认继承。需要共享的数据显式传入,请求态隔离要避免可变对象被多协程持有。

概念解释

go() 闭包通过 use 捕获父作用域变量,对象按引用捕获,标量按值(与 PHP 闭包规则一致)。协程上下文存储的继承策略由运行时与框架封装决定:有的实现派生时复制,有的不传递。跨协程共享可变对象会回到污染与竞争问题,需要同步原语保护。

原理流程

  1. 父协程创建子协程,闭包 use 所需变量。
  2. 捕获的对象在父子协程间共享引用。
  3. 私有上下文按实现规则决定是否传递给子协程。
  4. 子协程内修改共享对象需评估竞争与隔离边界。

代码或图示

use Swoole\Coroutine;

$shared = ['trace' => 't-1001'];

go(function () use ($shared) {
    // $shared 与父协程共享同一数组引用(数组写时复制规则以 PHP 行为为准)
    echo $shared['trace'] . "\n";
});

常见误区

  • 以为子协程自动拥有父协程全部上下文:继承策略未确认前按不继承处理。
  • 把请求态对象直接 use 进多个子协程:可变属性被并发修改,需只读化或加锁。

追问

  • 闭包捕获对象与数组有何不同?答:对象按引用共享;数组按 PHP 写时复制规则,修改时复制,具体行为以 PHP 手册为准。
  • 链路 ID 如何贯穿子协程?答:显式作为参数传入,或依赖框架上下文传播机制;不要假设自动继承。

06.5.6.2-018 hook 开关在不同 Swoole 版本之间有哪些需要核对的变化?

一句话结论

hook 常量命名、覆盖函数清单、默认 flags 与对新 PHP 版本的兼容都可能随大版本调整;接入前必须按安装版本对照官方文档,不能沿用旧版本结论。

概念解释

升级版本时常出现:常量名重命名、某类 hook 拆分或合并、默认行为变化、某些函数退出覆盖列表。面试中可说明排查路径:先 php --ri swoole 取版本,再查对应版本文档 hook 章节,最后最小脚本实测。不确定的默认值与行为写「待确认」并附验证命令。

原理流程

  1. 记录 PHP 版本与 Swoole 版本号。
  2. 对照目标版本文档确认 hook 常量与覆盖范围。
  3. 编写最小并发脚本验证关键函数挂起行为。
  4. 记录版本差异点,业务代码按实测结论编写。

代码或图示

php -v
php --ri swoole

常见误区

  • 拿旧博客或旧文档的常量名直接用:版本不符可能常量不存在或行为不同。
  • 不验证默认 flags:未显式传参时的默认组合以版本文档为准,待确认。

追问

  • 如何查某函数在目标版本是否被 hook?答:官方 hook 章节列出函数清单;清单未覆盖时用并发压测观察是否阻塞 Worker。
  • 升级后回归重点是什么?答:数据库/Redis/curl/sleep/文件流路径的并发表现、连接交叉读写与错误返回。

06.5.6.2-019 hook 之后错误抑制与返回值有什么注意点?

一句话结论

被 hook 函数在挂起/恢复后返回值与错误约定需按版本核对;错误抑制符、异常抛出与原生行为可能不一致,不能照搬 FPM 下的错误处理经验。

概念解释

协程化实现可能改变错误返回形式:返回 false、抛异常、触发错误回调的路径与原生函数不同。业务代码应显式检查返回值与错误码,不依赖 @ 抑制掩盖问题;连接超时、对端中断等场景要在协程内捕获并记录上下文。具体返回约定标注待确认,以官方文档与实测为准。

原理流程

  1. 协程内调用被 hook 函数。
  2. 等待失败(超时、中断、错误)时按扩展约定返回或抛出。
  3. 业务显式判断返回值/错误码,进入降级或重试。
  4. 错误信息带 CID 与链路标识入日志,便于并发下定位。

代码或图示

go(function () {
    $result = file_get_contents('https://example.com');
    if ($result === false) {
        echo "fetch failed\n"; // 失败分支需显式处理,具体错误接口以版本为准
    }
});

常见误区

  • 用 @ 抑制 IO 错误后不检查返回:协程化后错误形态可能变化,抑制会掩盖连接问题。
  • 假设错误一定以异常形式抛出:部分接口返回 false 或错误码,需分情况处理。

追问

  • 超时后协程状态如何?答:超时触发恢复后协程继续执行错误分支;挂起期间资源占用需确认,连接是否释放按客户端实现核对。
  • 如何统一错误日志?答:在协程入口与 IO 边界捕获错误,记录 CID、链路 ID、目标地址与错误码。

06.5.6.2-020 如何排查 hook 未生效或部分阻塞的问题?

一句话结论

按“扩展版本 → flags 类别 → 目标函数是否在覆盖清单 → 并发复现 → 定位未 hook 调用点”的顺序排查;先用 php --ri swoole 与最小脚本确认运行时环境,再逐类裁剪 flags 缩小范围。

概念解释

hook 未生效常见原因:扩展未加载、开启时机过晚、flags 未覆盖该类别、目标函数属于未支持扩展、回调不在协程上下文。排查时先证明环境与开关正常,再用并发脚本对比串行耗时,锁定卡住的函数类别,最后核对文档清单与版本行为。

原理流程

  1. php --ri swoole 确认扩展已加载且版本明确。
  2. 检查 enableCoroutine 调用时机与 flags 是否覆盖目标类别。
  3. 确认回调运行在协程上下文(Coroutine::getCid())。
  4. 最小并发脚本复现阻塞,裁剪 flags 定位未 hook 调用点。
  5. 对照文档清单,必要时换协程客户端或隔离进程。

代码或图示

php -m | findstr /i swoole
php --ri swoole
use Swoole\Runtime;
use Swoole\Coroutine;

Runtime::enableCoroutine(SWOOLE_HOOK_ALL);
go(function () {
    var_dump(Coroutine::getCid()); // 确认处于协程上下文
});

常见误区

  • 一上来怀疑框架问题:先排除扩展未加载、flags 缺失等运行时层原因。
  • 只在串行环境验证:阻塞问题必须并发复现,单请求耗时正常不代表 hook 生效。

追问

  • 如何判断是“未 hook”还是“下游慢”?答:对比直连下游的耗时与并发下 Worker 表现;下游慢会有等待事件,未 hook 阻塞会占住 Worker 不释放。
  • 排查需要记录哪些信息?答:Swoole 版本、PHP 版本、flags、调用栈、慢函数类别、并发数与内存;不确定项按版本文档标注待确认。