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

06.5.7.2 与 Swoole 的机制差异

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

06.5.7.2-001 Swow 与 Swoole 在阻塞函数 hook 范围与默认行为上有什么差异?

一句话结论

两者都会把 PHP 标准库中的阻塞 IO 调用 hook 到协程调度路径,但被覆盖的函数族集合、默认是否全量 hook、未覆盖函数清单需要对照双方当前版本文档确认;不能假设“Swoole hook 了的函数 Swow 一定 hook”。

概念解释

hook 范围决定哪些阻塞调用会在等待时让出协程。Swoole 历史上以 hook 常量分组(如网络、文件、sleep、curl、数据库等)控制启用范围;Swow 在扩展层 hook 大部分 IO 操作函数,具体分组、开关与默认列表以官方文档和 php --ri swow 输出为准。两者都可能存在未 hook 的纯计算阻塞或第三方扩展调用,那类调用会卡住整个事件循环。

原理流程

  1. 列出业务代码中所有可能阻塞的调用:sleep、文件读写、网络请求、数据库、缓存。
  2. 对照 Swow API 文档与扩展说明,确认各函数族是否在 hook 范围内。
  3. 对未覆盖调用改为协程安全客户端或异步封装。
  4. 压测观察事件循环是否被单个长阻塞调用卡住。

代码或图示

# 核对扩展加载与已暴露配置项(本机当前未安装 swow,结论待确认)
php --ri swow
php -m | Select-String swow

常见误区

  • 以为开启扩展后所有阻塞调用自动协程化:未被 hook 的调用仍会同步阻塞整个进程。
  • 把 Swoole 的 hook 分组常量套到 Swow:两者 flag 体系不同,需查 Swow 文档(待确认:Swow 是否提供分组开关)。

追问

  • 如何判断一个函数是否被 hook?答:在隔离协程中并发调用,观察其他协程是否被阻塞;结合官方文档函数清单确认。
  • 文件 IO 是否被 hook?答:双方对本地文件流的覆盖程度不同,需按版本核对;不确定时标注「待确认」。

06.5.7.2-002 协程创建方式有何差异?

一句话结论

Swoole 侧常用 Swoole\Coroutine\go() 或 Co::run() 启动协程;Swow 侧使用 Swow\Coroutine::run(callable, ...$data) 静态方法立即运行,也可以 new Swow\Coroutine(callable) 先构造待运行对象再 resume()。

概念解释

Swow 协程是对象:构造只申请内存并进入 waiting,resume() 统一唤醒路径;run() 是“创建并立即运行”的便捷静态方法。Swoole 历史上提供过程式 go() 与类静态方法两种入口,返回协程 ID。创建入口不同带来持有方式差异:Swow 可直接持有协程对象做观测与唤醒,Swoole 早期更多通过 ID 操作。

原理流程

  1. Swow 快速启动:Coroutine::run($closure, ...$args),返回新协程对象。
  2. Swow 延迟启动:new Coroutine($closure) 构造对象,稍后 $co->resume()。
  3. 对照 Swoole:go($closure) 返回 ID,或 Coroutine::run() 包裹协程入口。
  4. 迁移时把“ID 操作”改写为“对象引用 + 状态查询”模式。

代码或图示

<?php
// 文档示例(未实测):Swow 两种创建方式
use Swow\Coroutine;

$co = Coroutine::run(static function (int $a): void {
    echo $a;
}, 1);

$pending = new Coroutine(static function (): void {
    echo "later";
});
$pending->resume();

常见误区

  • 以为 new Coroutine() 会自动运行:构造后处于 waiting,需要 resume() 才执行。
  • 迁移时直接保留 go() 调用:Swow 入口是 Coroutine::run(),全局 go() 函数是否存在待确认。

追问

  • run() 传参方式?答:run(callable $callable, mixed ...$data),可变参数透传给协程体。
  • 协程对象在哪里被持有?答:变量引用、容器或映射表;不持有对象时只能通过 Coroutine::getAll() 遍历观测。

06.5.7.2-003 两者 API 的错误语义有什么差异?

一句话结论

Swow 倾向于在失败时抛出对应命名空间异常(如 ChannelException、SocketException),Swoole 历史上大量接口返回 false/null 并通过错误码获取失败原因;迁移时错误处理分支必须从返回值判断改为异常捕获。

概念解释

异常语义差异影响整套错误处理代码:Swow 侧通过 try/catch 捕获 Swow\Exception 及其子类,异常携带错误码;Swoole 侧常见 if ($result === false) { $errCode = $client->errCode; } 模式。返回值类型也不同:成功数据、失败标识不能混用。面试回答时要区分“抛异常的方法”与“返回状态的方法”,以当前版本 API 文档为准。

原理流程

  1. 梳理现有 Swoole 代码中的返回值判断与 errCode 分支。
  2. 在 Swow 文档定位对应方法,确认失败是抛异常还是返回值。
  3. 把 === false 分支改写为 catch (XxxException),读取异常码与消息。
  4. 保留超时、关闭、EOF 等细分错误类型的判断分支。

代码或图示

<?php
// 文档示例:Swow Channel 超时/关闭走异常路径
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(1);
try {
    $data = $channel->pop(1000);
} catch (ChannelException $e) {
    // 超时与关闭对应不同错误码,具体码值以 API 文档为准
    $code = $e->getCode();
}

常见误区

  • 用返回 false 判断 Swow 方法失败:可能根本不返回 false,而是直接抛异常。
  • 捕获基类异常后丢弃细分错误:超时、连接关闭、EOF 需要分别处理。

追问

  • Swow 异常基类是什么?答:命名空间下存在 Swow\Exception 及 ChannelException、SocketException 等子类;继承关系以 API 文档为准(待确认)。
  • 错误码常量在哪里?答:Swow\Errno 类提供错误码常量;具体常量名需对照文档。

06.5.7.2-004 两者事件循环实现上有什么差异?

一句话结论

两者都依赖 IO 多路复用驱动协程就绪与恢复,但 Swow 调度器与协程对象模型绑定更紧,事件循环、超时等待、协程唤醒由扩展内部统一管理;Swoole 历史上 Reactor/Worker 进程模型与事件循环耦合更深。

概念解释

事件循环负责等待 fd 可读可写、定时器到期,再把对应协程切回就绪队列。Swow 侧可以通过 Coroutine::getAll() 观测挂起协程,调度细节封装在扩展内;Swoole 侧对外暴露 Reactor ID、进程模型等概念。底层复用的系统机制(epoll/kqueue 等)属于实现细节,版本相关内容标注待确认,不凭源码记忆下结论。

原理流程

  1. 协程调用被 hook 的 IO,等待事件时挂起并记录等待条件。
  2. 调度器切到其他就绪协程执行。
  3. 事件循环检测到 fd/定时器就绪,唤醒对应协程回到就绪队列。
  4. 被唤醒协程在后续调度中恢复执行。

代码或图示

<?php
// 文档示例:观测当前存活协程列表,辅助判断事件循环上挂了哪些协程
use Swow\Coroutine;

$all = Coroutine::getAll();
foreach ($all as $id => $co) {
    echo $id, ": ", $co->getStateName(), PHP_EOL;
}

常见误区

  • 以为事件循环是 PHP 层实现:核心等待与唤醒在扩展 C 侧完成。
  • 把 Reactor 概念直接套到 Swow:Swow 对外暴露的是协程与组件,Reactor 拓扑是否可见待确认。

追问

  • 底层多路复用机制如何确认?答:查看扩展编译信息、官方文档与源码;Linux 下通常对应 epoll,具体以官方说明为准(待确认)。
  • 事件循环卡住怎么查?答:遍历存活协程状态与调用栈,定位挂起在未 hook 阻塞调用上的协程。

06.5.7.2-005 两者依赖关系与 PHP 兼容性有何差异?

一句话结论

Swoole/OpenSwoole 与 Swow 各有 PHP 版本约束、依赖库(如 OpenSSL、curl 等)与编译选项;具体兼容矩阵必须以双方当前发布的 Packagist/PECL 元数据为准,不能用历史版本印象判断。

概念解释

扩展安装依赖 PHP 头文件、编译工具链与系统库;网络 TLS 能力依赖 OpenSSL 支持选项。Swow 扩展包标注 PHP >=8.0 与 ZTS/NTS 支持情况;Swoole 各分支 PHP 版本要求不同。同一台机器上两个扩展能否共存也需实测,避免 hook 层冲突。

原理流程

  1. 查 composer show 或包页面的 PHP 版本约束。
  2. 核对编译选项:SSL 支持、调试构建等。
  3. 在目标环境安装后用 php --ri 确认扩展信息。
  4. 验证两者(或与其他扩展)共存时无加载冲突。

代码或图示

# 环境与扩展核对示例(本机当前未安装 swoole/swow,输出待确认)
php -v
php -m
php --ri swow
composer show swow/swow

常见误区

  • 以为老项目 PHP 7.x 能直接装新版 Swow:版本约束不满足时编译或加载都会失败。
  • 忽视 TLS 编译选项:未启用 SSL 支持时 HTTPS/WSS 能力不可用。

追问

  • 两个扩展能同时加载吗?答:理论上需验证 hook 与符号是否冲突;生产环境通常只选一个运行时,共存结论待确认。
  • 依赖缺失时安装报什么?答:编译阶段报缺少头文件或库;运行阶段报类/函数未注册。

06.5.7.2-006 协程调度模型上有何差异?

一句话结论

两者均为协作式调度:协程在 IO 等待、主动让出时切换,不靠时间片抢占;Swow 明确采用类似 Go 的模型——主协程退出后其余协程随进程退出,协程是可观测、可持有的对象。

概念解释

协作式意味着 CPU 密集死循环不会被调度器强制打断,其他协程随之饿死。Swow 主协程是“真正意义上的主协程”,主协程退出后所有协程一同退出,因此常驻服务需要在主协程内等待或由 Supervisor 维持进程。Swoole 侧协程生命周期与 Server 事件循环绑定,入口在 Server 回调内启动。

原理流程

  1. 协程运行直到遇到被 hook 的 IO 或主动 yield()。
  2. 调度器选择下一就绪协程,保存/恢复栈上下文。
  3. IO 就绪后原协程回到就绪队列,等待再次被调度。
  4. 主协程结束 → 进程退出,子协程不再继续执行。

代码或图示

<?php
// 文档示例:主协程若不等待,子协程会随主协程退出而被终止
use Swow\Coroutine;
use function Swow\Sync\waitAll;

Coroutine::run(static function (): void {
    echo "worker started";
});
waitAll(); // 等待所有协程退出,避免主协程直接结束

常见误区

  • 以为协程被抢占式调度:长 CPU 循环必须拆分为让出点或放到进程/线程模型处理。
  • 以为子协程会脱离主协程独立存活:主协程退出后进程退出,子协程被一并终止。

追问

  • 如何避免主协程提前退出?答:WaitGroup、WaitReference、Channel 等待或常驻 Server 循环;详见 06.5.7.5。
  • Swow 有抢占调度吗?答:按公开设计为协作式;是否存在辅助抢占机制待确认,以官方文档为准。

06.5.7.2-007 定时器与延迟任务的实现位置有何差异?

一句话结论

Swoole 提供独立的 Swoole\Timer 定时器模块;Swow 侧延迟等待通常基于协程 sleep、Sync 超时参数与事件循环定时器实现,是否有独立 Timer 类需对照当前 API 文档确认,不能假设同名类存在。

概念解释

定时器本质是事件循环上的到期回调。Swoole Timer 提供循环定时器、一次性任务与计数管理;Swow 侧常见做法是协程内 sleep() 配合循环,或在 wait/pop/push 上设置超时毫秒数。Swow 命名空间类清单中未列出独立 Timer 类(以当前文档快照为准,待确认是否有补充包)。

原理流程

  1. 识别需求:一次性延迟、周期执行、超时控制。
  2. 超时控制优先用同步设施的 timeout 参数(毫秒)。
  3. 周期任务用独立协程循环 + sleep 实现,注意退出信号与取消。
  4. 对照官方文档确认是否有封装好的定时器组件。

代码或图示

<?php
// 文档示例:周期任务协程骨架(退出信号处理见 Signal 相关主题)
use Swow\Coroutine;

Coroutine::run(static function (): void {
    while (true) {
        sleep(1);
        // 执行周期任务
    }
});

常见误区

  • 直接把 Swoole\Timer::tick() 搬到 Swow:类名与回调模型未必对应。
  • 周期协程不处理退出:进程停止时任务协程可能被强杀,需做清理。

追问

  • sleep 是否被 hook?答:Swow hook 大部分 IO 与等待函数,sleep() 在协程内让出调度;具体覆盖清单待确认。
  • 定时器精度由谁保证?答:事件循环超时机制;高精度定时需求需实测,文档不承诺精度数值。

06.5.7.2-008 信号处理机制有何差异?

一句话结论

Swoole 在 Server 模型下提供信号回调注册;Swow 提供 Swow\Signal 类,通过 Signal::wait(Signal::INT) 等方式在协程内等待信号,信号处理与协程调度结合。

概念解释

信号处理要避免在异步信号上下文中执行复杂逻辑。Swow 侧把信号等待纳入协程模型:业务协程 wait 指定信号,信号到达后协程被唤醒,再走正常协程代码路径做清理。Swoole 侧通过 Server->on('signal') 或信号方法注册回调;两者注册与触发位置不同,迁移需重写信号分支。

原理流程

  1. 启动专门协程等待 Signal::INT、Signal::TERM 等退出信号。
  2. 信号到达后等待协程唤醒,通过 Channel 通知主流程优雅退出。
  3. 主流程收尾:停止接收新连接、归还资源、退出协程。
  4. 对照 Swoole 信号回调模型改造注册代码。

代码或图示

<?php
// 文档示例:信号等待与退出通知(骨架,未实测)
use Swow\Channel;
use Swow\Coroutine;
use Swow\Signal;

$channel = new Channel();
Coroutine::run(static function () use ($channel): void {
    Signal::wait(Signal::INT);
    $channel->push("stopped");
});

常见误区

  • 在信号回调里直接做重 IO:信号上下文应只做通知,重活在协程内完成。
  • 忽略 TERM 信号:容器编排通常发 TERM 触发优雅退出。

追问

  • 信号常量有哪些?答:Signal::INT、Signal::TERM 等;完整常量清单对照 Swow\Signal API 文档(待确认)。
  • Windows 下信号行为一致吗?答:Windows 信号语义与 Unix 不同,部署以 Linux 为准,本地 Windows 调试结论不直接外推。

06.5.7.2-009 进程与自定义进程模型有何差异?

一句话结论

Swoole 内置 Manager/Worker/TaskWorker 进程树与自定义进程接口;Swow 核心不以内置 Server 进程树为中心,多实例与常驻进程由部署体系管理,扩展内另有线程相关类(Swow\Thread 等)作为补充,具体边界以文档为准。

概念解释

Swoole 进程模型是框架级服务端能力:Master 管理、Worker 处理、Task 异步任务都有对应 API 与回调。Swow 把并发建立在协程上,进程拆分更多是部署决策;需要并行隔离 CPU 任务时,再评估线程类或多进程方案。迁移时不能把 Swoole Task 进程模型直接映射为 Swow 协程。

原理流程

  1. 梳理现有 Swoole 进程角色:Master、Worker、Task、自定义 Process。
  2. 逐角色判断在 Swow 体系中的替代:协程、独立进程实例、线程类或外部队列消费进程。
  3. 进程间通信方式相应调整:IPC 组件、消息队列、共享存储。
  4. 部署配置按多实例重写,而不是沿用内置进程树配置。

代码或图示

对照方向
Swoole Worker 进程      ↔  Swow 常驻进程实例(多副本部署)
Swoole Task 异步进程    ↔  队列消费进程 / 协程任务(按任务性质选择)
Swoole 自定义 Process   ↔  独立脚本进程 / Swow 线程类(待确认适用边界)

常见误区

  • 以为协程可以替代所有任务进程:CPU 密集、阻塞隔离需求仍需进程/线程边界。
  • 在单协程内跑无限循环当后台进程:应明确独立协程或独立进程的生命周期归属。

追问

  • 线程类 API 成熟度如何?答:Swow\Thread、Swow\ThreadManager 存在于命名空间,适用场景与稳定性待确认,需对照 API 文档与 issue。
  • 进程间共享状态怎么办?答:走外部存储或共享内存组件,不能假设进程内存互通。

06.5.7.2-010 协程 ID 与协程对象获取方式有何差异?

一句话结论

Swoole 侧常用 Coroutine::getCid() 获取数字 ID,按 ID 反查能力有限;Swow 侧 Coroutine::getCurrent() 返回当前协程对象,getId() 取数字 ID,Coroutine::get($id) 按 ID 反查对象,Coroutine::getAll() 遍历全部存活协程。

概念解释

Swow 协程是一等对象,观测信息挂在对象上:状态、切换次数、耗时、调用栈。Swoole 早期以 CID 为主要标识,协程信息通过静态方法查询。迁移时日志与排障代码中的“取 ID”要扩展为“取对象 + 读状态/栈”,便于定位挂起点。

原理流程

  1. 当前协程:Coroutine::getCurrent();主协程:Coroutine::getMain()。
  2. 数字标识:$co->getId();按 ID 反查:Coroutine::get($id)。
  3. 全量观测:Coroutine::getAll() 返回 ID 到对象的映射。
  4. 排障时读取 getStateName()、getTraceAsString() 等信息。

代码或图示

<?php
// 文档示例:协程标识与观测信息
use Swow\Coroutine;

$co = Coroutine::run(static function (): void {
    $current = Coroutine::getCurrent();
    echo $current->getId();
});
echo $co->getId(), $co->getStateName();

常见误区

  • 只记录 CID 不保留对象引用:挂起协程的栈与状态需要对象方法读取。
  • 把 ID 当持久句柄:协程退出后 ID 对应的对象不可用,需用 isAvailable() 判断。

追问

  • 协程 ID 是否会复用?答:ID 分配规则与回收策略待确认;排障时不要假设 ID 全局永久唯一。
  • 主协程如何获取?答:Coroutine::getMain() 返回最外层协程对象。

06.5.7.2-011 协程上下文抽象有何差异?

一句话结论

Swoole 生态常见 Co\Context 静态键值存取;Swow 本身不强调内置全局上下文容器,请求态数据优先通过参数传递与协程私有对象管理,是否提供独立 Context 类需核对当前库版本。

概念解释

上下文用于在协程内跨函数传递请求信息(用户身份、追踪 ID 等)。Swoole 框架层通常封装 Context 按 CID 隔离存取;Swow 侧 API 清单中未见独立 Context 根类(待确认),更推荐显式传参或在协程内持有上下文对象。上下文丢失、跨协程复制是常驻模型高频问题,框架可能在此之上再做封装。

原理流程

  1. 识别需要跨函数传递的请求态字段。
  2. 优先封装为上下文对象,作为参数在调用链传递。
  3. 派生新协程时显式复制需要的字段,不依赖隐式继承。
  4. 若框架提供上下文封装,核对其隔离键是协程 ID 还是对象引用。

代码或图示

<?php
// 文档示例:上下文对象显式传递,不写全局静态容器
final class RequestContext
{
    public function __construct(public readonly int $userId, public readonly string $traceId)
    {
    }
}

function handle(RequestContext $ctx): array
{
    return ['uid' => $ctx->userId];
}

常见误区

  • 假设存在与 Swoole 同名的 Context 静态门面:未确认前不要调用不存在的方法。
  • 派生协程后隐式读取父协程上下文:协程间不自动继承局部变量。

追问

  • Swow 是否有上下文相关类?答:以 API 文档 Swow\ 命名空间清单为准;本批未列入独立 Context 主题,后续生态集成批次补充(待确认)。
  • 跨协程传递大数据怎么办?答:走 Channel 传递或共享不可变对象,避免隐式拷贝假设。

06.5.7.2-012 Channel 抽象有何差异?

一句话结论

两者都做协程间队列通信,但 Swow Swow\Channel 容量支持 0(无缓冲)、正数(有界缓冲)、-1(无上限),超时单位为毫秒,关闭后已排队值仍可弹出,等待者以异常唤醒;Swoole Channel 的容量约束、返回值与错误码语义需单独对照。

概念解释

Channel 语义要点:容量、阻塞条件、超时异常、关闭行为、状态查询。Swow 文档明确:push(T $data, int $timeout)、pop(int $timeout) 抛 ChannelException(超时码 -110、关闭码 -9758 等,以文档为准);close() 后排队值仍可 pop,等待协程以错误码 -125 唤醒。Swoole Channel 历史上 push/pop 返回布尔/数据,错误经 errCode 获取。

原理流程

  1. 按是否需要缓冲选择容量:0 为会合式,正数限制积压,-1 不限制。
  2. 读写阻塞时挂起协程,超时抛 ChannelException。
  3. 关闭通道:通知等待者,存量数据继续可取完。
  4. 迁移时把返回值判断改为异常捕获,核对超时单位与错误码。

代码或图示

<?php
// 文档示例:有缓冲通道 + 超时读取
use Swow\Channel;
use Swow\ChannelException;

$channel = new Channel(8);
$channel->push("task", 1000);
try {
    $item = $channel->pop(1000);
} catch (ChannelException $e) {
    $item = null;
}

常见误区

  • 以为容量 0 等于不能传值:0 是无缓冲会合语义,发送与接收需同时就位。
  • 关闭通道后直接丢弃存量数据:Swow 设计上排队值仍可被 pop 取出。

追问

  • 状态查询方法有哪些?答:getCapacity()、getLength()、isEmpty()、isFull()、isReadable()、isWritable()、hasConsumers()、hasProducers()。
  • 详细用法见哪一页?答:06.5.7.4 Channel 协程通信。

06.5.7.2-013 同步设施有何差异?

一句话结论

Swoole 生态有 WaitGroup、Barrier、batch 等封装;Swow 提供 Swow\Sync\WaitGroup(add/done/wait)与基于引用计数的 Swow\Sync\WaitReference,另有 waitAll() 辅助函数;计数语义、唤醒条件与超时传参需逐一对照。

概念解释

WaitGroup 显式计数:add(delta) 增计数,done() 减一,归零唤醒 wait() 等待者。WaitReference 利用 PHP 对象引用计数:闭包引用对象使计数增加,闭包退出计数减少,引用归零时 WaitReference::wait() 唤醒。两者选型取决于是否愿意显式管理计数。Swoole 的批量并行封装在 Swow 侧可能需要自行组合 Channel + WaitGroup。

原理流程

  1. 显式计数场景用 WaitGroup:启动前 add,任务结束 done,汇总处 wait。
  2. 引用绑定场景用 WaitReference:把对象引用带进协程闭包,无需手写 done。
  3. 脚本级等待可用 waitAll($timeout),粒度粗,不推荐业务核心路径使用。
  4. 对照 Swoole 批量工具时,评估结果收集方式(Channel 数组 vs 返回值映射)。

代码或图示

<?php
// 文档示例:WaitGroup 计数骨架
use Swow\Coroutine;
use Swow\Sync\WaitGroup;

$wg = new WaitGroup();
$wg->add(2);
foreach ([1, 2] as $i) {
    Coroutine::run(static function () use ($wg, $i): void {
        // 任务逻辑
        $wg->done();
    });
}
$wg->wait(5000);

常见误区

  • 在协程内部 add:计数可能在 wait 之后才增加,导致提前返回。
  • 把 WaitReference 当 WaitGroup 用:它没有显式 done,计数来自引用关系。

追问

  • 超时单位是什么?答:Swow 同步设施超时参数按毫秒传入;具体以 API 文档为准(待确认)。
  • 详细语义见哪一页?答:06.5.7.5 Sync 等待与同步。

06.5.7.2-014 网络 API 封装层级有何差异?

一句话结论

Swoole 对外提供 Server、Client、Http\Server 等高层对象与回调模型;Swow 以 Swow\Socket 等底层组件为中心,连接接受、读写、分帧在应用/框架层组合,高层协议封装由库或框架补齐。

概念解释

高层 Server 模型把监听、连接对象、事件回调、协议解析收敛好;Socket 组件暴露连接级读写方法(如 readString、recvString,超时毫秒)。迁移到 Swow 时,原 Server 回调中的业务逻辑要拆解为连接循环与读写处理。HTTP 消息抽象依赖 PSR 相关库层包。

原理流程

  1. 把现有服务端按“监听接受 → 连接读写 → 协议解析 → 业务处理 → 关闭回收”拆步。
  2. 在 Swow Socket 组件上对应实现各步骤。
  3. 协议分帧借助 Buffer 完成粘包拆包。
  4. 高层 HTTP/RPC 能力优先复用框架或官方库组件,不自研重复协议栈。

代码或图示

<?php
// 文档示例:Socket 读取指定长度数据的方法签名形态(未实测)
use Swow\Socket;

// $socket = new Socket(...);
// $data = $socket->readString(1024, 3000);

常见误区

  • 以为 Swow 缺少网络能力:能力在 Socket/Buffer 层,只是封装层级不同。
  • 忽略连接关闭与异常分支:EOF、超时、对端断开都要处理回收。

追问

  • Socket 类型有哪些?答:TCP、UDP、Unix Socket 等类型常量对照 Swow\Socket API 文档(待确认)。
  • Server 主题在哪一批?答:06.5.7.9 Server 与网络编程(规划中)。

06.5.7.2-015 连接池在两者中的位置有何差异?

一句话结论

Swoole 生态常由框架或 Swoole\ConnectionPool 类提供连接池;Swow 扩展核心不绑定特定数据库客户端连接池,池化策略由框架/组件基于 Socket 与同步原语实现,使用时必须确认所用客户端的协程安全性。

概念解释

连接池解决“长连接复用 + 并发借还”问题。底层连接是否可在多协程间共享,取决于客户端实现是否协程安全;未做协程化的连接被并发调用会产生数据错乱。Swow 侧应关注:连接对象归属、借还时机、空闲回收、池耗尽等待,而不是假设扩展自带通用池。

原理流程

  1. 确认所用 DB/Redis/HTTP 客户端在 Swow 下是否协程安全。
  2. 按组件文档获取池化客户端,或自行基于 Channel/队列实现借还。
  3. 借出连接后在请求内独占使用,结束归还,异常路径也要归还。
  4. 压测池耗尽、长连接断开与重连场景。

代码或图示

连接池检查清单
客户端是否协程安全 → 最大/最小连接配置 → 借出与归还路径
  → 异常归还保证 → 空闲淘汰 → 耗尽等待策略 → 监控指标

常见误区

  • 把一个连接对象在多个协程间并发调用:非协程安全客户端会串包。
  • 协程异常退出不归还连接:连接泄漏最终耗尽池。

追问

  • Swow 有没有内置连接池类?答:根命名空间清单未见通用 ConnectionPool 类;以框架组件为准(待确认)。
  • 数据库主题归属哪里?答:本章节聚焦运行时差异;具体 DB 池实践见后端框架与数据库分册。

06.5.7.2-016 协程内未捕获异常的行为有何差异?

一句话结论

未捕获异常在协程内会中断该协程执行,异常如何上报、是否影响其他协程与进程,双方默认行为与处理钩子需对照版本确认;Swow 提供协程对象 throw() 方法与死锁处理器等机制,具体传播路径以文档为准。

概念解释

协程异常不像 FPM 请求那样直接终结整个进程;单协程崩溃不应自然拖垮其他协程,但未处理的异常可能丢失记录。需要在协程入口统一 try/catch,记录日志并走资源回收;框架层通常有全局协程异常处理器。Swow 可通过 Coroutine::throw(Throwable) 向指定协程注入异常,调试与测试场景使用。

原理流程

  1. 协程体顶层包裹 try/catch,捕获业务与 IO 异常。
  2. 异常路径执行 defer/finally 清理:归还连接、关闭句柄。
  3. 记录协程 ID、调用栈与上下文标识,便于追溯。
  4. 评估是否需要全局异常钩子;可用机制以扩展/框架文档为准。

代码或图示

<?php
// 文档示例:协程入口统一异常兜底
use Swow\Coroutine;

Coroutine::run(static function (): void {
    try {
        // 业务与 IO 调用
    } catch (\Throwable $e) {
        echo $e->getMessage(), PHP_EOL;
    }
});

常见误区

  • 假设主协程能自动捕获子协程异常:协程异常不自动冒泡到父协程。
  • 异常后跳过资源回收:必须保证 finally/defer 路径归还连接与缓冲。

追问

  • 异常处理专题在哪一页?答:06.5.7.10 错误处理与异常传播(规划中)。
  • Coroutine::throw() 什么场景用?答:向目标挂起协程注入异常以中断或测试;误用会打断其他协程正常流程。

06.5.7.2-017 内存回收与协程销毁路径有何差异?

一句话结论

两者协程结束后都回收协程栈与执行上下文,PHP 堆对象按引用计数释放;差异在于协程对象持有方式、退出状态可观测性与析构钩子。Swow 协程有 waiting/running/dead 状态与退出状态、耗时等观测字段,退出后对象是否可继续访问由可用性检查保护。

概念解释

协程销毁路径:协程体返回或被 kill → 状态置 dead → 析构执行 → 栈与上下文释放。堆中对象若仍被外部引用则不释放。Swow 提供 isAvailable()、isAlive() 区分“构造完成可用”与“已开始运行仍存活”;退出后再操作不可用对象由底层防护。Swoole 侧协程退出后 CID 失效,相关查询行为按其文档。

原理流程

  1. 协程体正常返回、抛未捕获异常或被 kill() 终止。
  2. 状态流转到 dead,记录结束时间与退出状态。
  3. 析构函数执行,协程栈释放。
  4. 外部持有的对象引用按引用计数决定是否释放。

代码或图示

<?php
// 文档示例:退出后可用性检查
use Swow\Coroutine;

$co = Coroutine::run(static function (): void {
});
// 稍后检查:isAvailable() / isAlive() 复合判断
var_dump($co->isAvailable(), $co->isAlive(), $co->getStateName());

常见误区

  • 退出协程对象仍可 resume:dead 状态协程不可再唤醒。
  • 以为协程退出会释放它引用的单例:单例引用计数不归零就继续驻留。

追问

  • 协程计数如何查看?答:Coroutine::count() 返回当前协程数量;getAll() 遍历存活对象。
  • 析构中做什么安全?答:只做资源归还与日志,避免再触发新的阻塞调度;细节待确认。

06.5.7.2-018 生态包与代码复用性有何差异?

一句话结论

Swoole 生态积累了大量协程化组件、框架适配与生产案例;Swow 生态围绕 swow/swow 与适配框架成长,组件复用需逐个确认是否支持 Swow 运行时,不能按“同为协程扩展”假设兼容。

概念解释

PHP 库分三类:纯逻辑无 IO(通常可直接复用)、依赖同步阻塞扩展(需协程化适配)、直接绑定 Swoole API(需要改写)。复用判断看依赖:Composer 依赖是否引用 swoole 扩展、调用的函数是否被 hook、客户端是否维护连接状态。框架层的 Swow 适配是生态关键环节。

原理流程

  1. 列出项目全部 Composer 依赖与直接使用的扩展函数。
  2. 分类:纯逻辑 / IO 客户端 / Swoole 绑定代码。
  3. 对 IO 客户端查协程安全说明,隔离环境实测并发调用。
  4. 对 Swoole 绑定代码编写 Swow 适配层或替换组件。

代码或图示

# 盘点项目依赖(示例命令,输出以实际项目为准)
composer show --tree
composer why ext-swoole

常见误区

  • 以为协程化库与运行时无关:客户端内部连接管理可能绑定特定扩展 API。
  • 只看 README 支持字样:以实际并发压测与源码调用为准。

追问

  • 生态兼容专题在哪一页?答:06.5.7.12 生态兼容与框架集成(规划中)。
  • 框架已有 Swow 适配时还要自查什么?答:框架版本、扩展版本匹配,以及框架未覆盖的自定义客户端与底层调用。

06.5.7.2-019 迁移成本从哪些维度评估?

一句话结论

迁移成本按 API 改写量、阻塞调用覆盖度、生态适配缺口、状态改造量、测试与排障储备五个维度评估;建议先做最小原型量化每个维度的实际工作量,而不是按代码行数粗估。

概念解释

API 改写:命名空间、方法名、返回值/异常语义逐项替换。阻塞覆盖:未 hook 的调用需要换协程客户端。生态缺口:无 Swow 适配的组件需自研或替换。状态改造:全局/静态/单例请求态清理。测试排障:协程挂起、泄漏、上下文丢失需要观测手段与压测基线。

原理流程

  1. 代码扫描:统计 Swoole 类/函数引用点与第三方依赖。
  2. 分类清单:直接替换、语义改写、缺失替代、状态改造。
  3. 原型迁移核心链路:登录、主接口、数据库、缓存、下游调用。
  4. 压测对比吞吐/延迟/内存,记录挂起与泄漏问题。
  5. 汇总工作量、风险与回退方案,给出分阶段迁移计划。

代码或图示

成本评估表字段
模块 | Swoole 用法 | Swow 对应 | 改造类型 | 工作量 | 风险 | 待实测项

常见误区

  • 用代码行数估算迁移:复杂的状态与并发问题不体现在行数上。
  • 忽略测试成本:协程问题需要并发与异常路径用例覆盖。

追问

  • 迁移对照详细清单在哪一页?答:06.5.7.11 与 Swoole 的迁移对照(规划中)。
  • 高风险改造通常是哪些?答:连接管理、全局状态、异步任务、定时器与信号处理。

06.5.7.2-020 迁移前需要逐项核对的检查清单是什么?

一句话结论

迁移核对清单覆盖:PHP 与扩展版本、hook 函数族、协程入口与同步设施、Channel/Sync 语义、网络组件、信号定时器、异常与回收、生态依赖、压测与回退方案;每一项标注当前结论与待验证命令。

概念解释

清单是迁移评审的输入,避免遗漏机制差异。每项结论三态:已确认(附版本与命令输出)、待确认(写明验证手段)、不适用(说明原因)。本批环境未安装扩展,涉及默认值与版本行为的条目均按待确认处理,闭环后再更新。

原理流程

  1. 环境项:PHP 版本、OS、扩展安装、ZTS/NTS、编译选项。
  2. 运行时项:hook 范围、调度行为、主协程退出规则。
  3. API 项:协程、Channel、Sync、Buffer、Socket、Signal 签名与异常。
  4. 生态项:框架、ORM、缓存、队列、日志、追踪适配。
  5. 验收项:并发压测、异常路径、资源回收、回退预案。

代码或图示

# 迁移前环境采集命令(示例,实际输出待确认)
php -v
php -m
php --ri swow
composer show swow/swow

常见误区

  • 清单只写“已替换”不写验证结果:无法回溯差异点是否闭环。
  • 跳过回退方案评审:迁移出问题时需要保留原运行时部署路径。

追问

  • 待确认项如何记录格式?答:条目 + 疑问点 + 验证命令(php --ri swow、反射方法、官方文档章节)+ 核对日期。
  • 本批文档与实测的关系?答:本批代码片段为文档示例,本机未安装扩展,不声称实测输出;构建验证由汇总方统一执行。