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

06.5.7.1 架构与设计定位

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

06.5.7.1-001 Swow 是什么?在 PHP 并发技术栈中处于什么定位?

一句话结论

Swow 是一套面向并发 IO 的 PHP 高性能运行时,以 C 扩展提供协程、调度器、网络与同步原语,上层由 Composer 库提供类与封装;定位是 Swoole 类协程运行时的替代选项,而不是 Web 框架。

概念解释

Swow 由 swow/swow-extension(ext-swow C 扩展)与 swow/swow(PHP 库)两部分组成。扩展层负责协程栈切换、IO hook、事件驱动;库层在扩展之上提供 Swow\Coroutine、Swow\Channel、Swow\Buffer、Swow\Socket 等面向对象的 API。业务框架(如 Hyperf 等)再基于这些能力组织服务。

原理流程

  1. 通过 PIE 或 Composer 安装器编译并加载 ext-swow,PHP 进程内获得协程调度能力。
  2. 引入 swow/swow Composer 包,获得命名空间下的类与辅助函数。
  3. 业务代码调用 Swow\Coroutine::run() 启动协程,阻塞 IO 在 hook 后自动让出调度。
  4. 框架或应用层在此之上实现 HTTP/RPC 服务编排。

代码或图示

<?php
// 文档示例:环境未安装 ext-swow 时无法实测,签名以官方 API 文档为准
use Swow\Coroutine;

Coroutine::run(static function (): void {
    echo "Hello Swow\n";
});

常见误区

  • 以为 Swow 自带 Web 框架:Swow 是运行时与组件层,路由、容器、ORM 等框架能力需要另行引入。
  • 以为 Swow 只是 Swoole 的 fork:两者在抽象层级、API 风格与内置组件取舍上均有独立设计,不能直接按 Swoole 经验套用。

追问

  • 如何确认本机是否加载了 ext-swow?答:执行 php --ri swow 查看扩展信息;未输出即未安装。
  • 库层包名是什么?答:Composer 包 swow/swow;扩展包 swow/swow-extension,扩展名 ext-swow(待确认:以 composer show swow/swow 输出的依赖为准)。

06.5.7.1-002 Swow 的 C 扩展与 Composer 库如何分层?

一句话结论

底层 ext-swow 用 C 实现协程调度、栈切换、IO hook 与底层系统调用封装;上层 swow/swow 用 PHP 实现面向对象的类、常量、异常与便捷封装;两层通过扩展注册的类与钩子衔接。

概念解释

扩展层是能力底座:协程结构体、栈内存、事件循环、阻塞函数 hook、Socket fd 包装等都在 C 侧完成。库层是 API 门面:把底层能力整理成 Swow\Buffer、Swow\Channel、Swow\Sync\WaitGroup 等类,并提供 PSR 相关适配。版本兼容、类是否存在,需要分别核对扩展版本与库版本。

原理流程

  1. 安装扩展后,php --ri swow 能看到扩展编译信息与加载的模块。
  2. Composer 安装 swow/swow,自动加载 Swow\ 命名空间下的 PHP 类。
  3. 业务代码调用 PHP 类方法,类内部调用扩展注册的底层能力。
  4. 排查问题时区分:底层崩溃/段错误属扩展层;类不存在、方法签名不符属库层或自动加载问题。

代码或图示

// composer.json 中典型依赖形态(具体版本以 lock 文件为准)
"require": {
    "php": ">=8.0",
    "swow/swow": "*"
}

常见误区

  • 以为只装 Composer 包就能跑:没有 ext-swow 扩展,协程与 hook 能力不存在,库类无法工作。
  • 以为扩展与库版本必须完全一致:两者有兼容矩阵,升级时需分别核对(待确认:核对 Packagist 上 swow/swow 的 require 约束)。

追问

  • 扩展安装有哪几种途径?答:PIE 安装 swow/swow-extension,或 Composer 拉源码后运行 vendor/bin/swow-builder --install 自动编译。
  • 如何查看扩展编译参数?答:php --ri swow 输出中的配置项与编译选项;具体字段以本机实际输出为准。

06.5.7.1-003 Swow 的核心设计目标有哪些?

一句话结论

Swow 围绕“高性能并发 IO、贴近原生系统调用、最小核心设计、面向对象的协程抽象”展开,强调 API 简洁、分层清晰与可组合性,把框架层决策留给上层。

概念解释

从公开设计资料看,Swow 追求博采众长而非生搬硬造:协程是面向对象的实体,同步设施、通道、缓冲区都是可组合的组件;核心尽量贴近系统调用语义,减少黑盒封装。设计取舍上,不把 Web Server、进程管理、连接池等全部塞进扩展,而是以组件形式提供基础能力。

原理流程

  1. 定义最小协程模型:创建、让出、唤醒、状态查询。
  2. 把 IO 并发建立在 hook 阻塞函数 + 调度器之上。
  3. 用 Channel、Sync、Buffer、Socket 等基础组件组合出业务模式。
  4. 框架层在组件之上做服务编排与生命周期管理。

代码或图示

<?php
// 文档示例:基础组件组合思路,不代表可在本机直接运行
use Swow\Channel;
use Swow\Coroutine;

$channel = new Channel(1);
Coroutine::run(static function () use ($channel): void {
    $channel->push("payload");
});

常见误区

  • 以为“最小核心”等于功能少:核心小,但通过 Socket、Buffer、Selector、Signal 等组件可组合出完整服务。
  • 以为设计目标与 Swoole 完全一致:两者都做协程并发,但 Swow 更强调组件化与贴近系统调用的抽象。

追问

  • 设计目标的一手资料在哪里核对?答:Swow 官方仓库 README、官方 API 文档与系列博客;本页结论为概述,细节以官方文档为准(待确认)。
  • “贴近原生系统调用”体现在哪里?答:Socket、文件描述符、信号、管道等组件命名与行为对齐系统调用概念,便于把系统编程知识迁移到 PHP 代码中。

06.5.7.1-004 Swow 与传统 Swoole 的出发点差异在哪里?

一句话结论

Swoole 早期以“内置大而全的 Server/进程模型/任务机制”为核心,API 长期保留过程式风格与全局别名;Swow 从协程对象、组件组合与现代 PHP 抽象出发,网络与服务能力以可组合类提供,进程管理等职责更多交给上层或外部 supervisor。

概念解释

对照角度:Swoole 提供 Swoole\Server、Task、Timer、进程管理等一体化服务端模型;Swow 核心是协程、Channel、Sync、Buffer、Socket 等基础原语,服务端逻辑由库层组件与应用代码组合。API 风格上 Swow 协程是对象,可持有、可观测、可 resume;异常语义上 Swow 倾向抛异常,Swoole 历史上大量接口返回 false 并配合错误码。

原理流程

  1. 先识别需求:是需要一体化 Server 模型,还是需要可组合的协程底座。
  2. 对照 API 风格:对象方法 vs 过程式函数与全局别名。
  3. 对照错误处理:异常抛出 vs 返回值 + errCode。
  4. 对照进程与部署模型:内置进程管理 vs 外部 supervisor + 常驻进程。

代码或图示

<?php
// 对照示意:Swow 侧协程对象(文档示例,未实测)
use Swow\Coroutine;

$co = Coroutine::run(static function (): void {
    // 协程体
});
var_dump($co->getId(), $co->getStateName());

常见误区

  • 以为两者 API 可以机械替换:命名空间、方法名、返回值与异常语义都不同,迁移需要逐接口核对。
  • 以为 Swow 不支持网络服务:它提供 Swow\Socket 等组件,只是不以内置大 Server 对象的形式封装。

追问

  • Swoole 内部机制本章节展开吗?答:不展开,只作对照引用;Swoole 细节见本仓库 06.5.6-Swoole 章节。
  • 差异结论以什么为准?答:以双方对应版本官方 API 文档为准;本页涉及版本行为处标注「待确认」。

06.5.7.1-005 哪些场景适合选用 Swow?

一句话结论

适合常驻内存的高并发 IO 密集型服务:HTTP/RPC 接口、网关、长连接服务、并发聚合调用、基于协程组件自行编排服务模型的后端项目;团队愿意按现代 PHP 对象式 API 组织代码。

概念解释

协程并发的收益在 IO 等待场景最明显:单进程内大量协程在等待网络、数据库、缓存响应时让出,其他协程继续执行。Swow 的组件化抽象适合需要自己控制服务结构、同步策略与缓冲区管理的项目;若已有成熟 Swoole 生态框架深度绑定,迁移收益需单独评估。

原理流程

  1. 识别业务瓶颈是否为 IO 等待而非 CPU 计算。
  2. 确认部署形态为常驻进程,而非每次请求拉起的 FPM 短生命周期。
  3. 评估团队是否接受协程安全编码约束(上下文隔离、资源归属)。
  4. 核对框架/组件生态是否提供 Swow 适配。

代码或图示

<?php
// 文档示例:并发拉取多个下游结果后汇总(骨架,未实测)
use Swow\Coroutine;
use Swow\Sync\WaitGroup;

$wg = new WaitGroup();
$results = [];
foreach (["a", "b", "c"] as $tag) {
    $wg->add();
    Coroutine::run(static function () use ($tag, $wg, &$results): void {
        $results[$tag] = "ok";
        $wg->done();
    });
}
$wg->wait(5000);

常见误区

  • 把 CPU 密集型计算当成协程收益场景:协程不减少 CPU 占用,计算密集型仍需进程/线程级并行。
  • 低估常驻内存改造成本:请求态数据、单例缓存、全局状态都需要重新梳理。

追问

  • 长连接场景适合吗?答:适合基于 Socket 组件维持长连接、按事件驱动读写;具体能力以 Swow\Socket 文档为准。
  • 与 FPM 部署相比收益如何量化?答:需以压测对比单实例吞吐、延迟与资源占用;本页不给出性能数值承诺。

06.5.7.1-006 哪些场景不建议选用 Swow?

一句话结论

传统 FPM 短生命周期站点、重度依赖未做协程化改造的同步扩展、对 Swoole 生态组件深度绑定且迁移成本高的项目,以及要求成熟稳定服务端框架开箱即用的场景,不建议贸然选用 Swow。

概念解释

协程运行时要求阻塞调用可被 hook 或主动异步化;若项目大量使用未适配协程的 C 扩展、全局状态与请求生命周期假设,改造风险高。生态成熟度、社区案例、招聘与排障资料也是选型约束。对稳定性要求极高且现有 Swoole 方案运行良好的系统,替换底座属于高风险动作。

原理流程

  1. 盘点依赖扩展:是否有未被 Swow hook 的阻塞 C 扩展。
  2. 盘点代码风格:静态变量、单例属性存请求态、全局连接复用等问题规模。
  3. 盘点生态:ORM、队列、缓存、配置、追踪组件是否有 Swow 适配。
  4. 评估团队排障能力:协程挂起、上下文丢失、泄漏等问题需要独立排查手段。

代码或图示

# 核对当前 PHP 已加载扩展(Windows PowerShell 示例)
php -m
php --ri swow

常见误区

  • 以为换运行时就能解决架构问题:连接管理、缓存一致性、并发安全仍需业务层改造。
  • 只看基准测试就选型:生态兼容与团队经验往往比理论吞吐更决定落地成败。

追问

  • 现有 Swoole 项目能否平滑切换?答:不能假设平滑;API 语义、hook 范围、生态适配都需逐项验证,详见 06.5.7.2 与 06.5.7.11。
  • 如何判断依赖扩展是否适配?答:查扩展官方协程支持说明,或在隔离环境压测观察是否阻塞事件循环;结论标注「待确认」并实测验证。

06.5.7.1-007 Swow 的进程模型是怎样的?是否内置多进程 Server 管理?

一句话结论

Swow 核心以单进程内协程并发为基本模型,不把 Swoole 式的主进程/Worker/Task 进程一体化管理作为核心内置能力;多进程或多实例水平扩展通常由部署侧(进程管理器、容器编排)与上层组件负责。

概念解释

协程本身运行在单线程调度内,进程内靠协程并发;Swow 命名空间下提供 Thread、ThreadManager 等线程相关类(具体可用性与语义以 API 文档为准),但服务端的多 Worker 拆分、进程拉起与监控一般交给外部 supervisor 或框架层。这与“扩展内置 Server 进程树”的传统模型形成对照。

原理流程

  1. 启动一个常驻 PHP 进程,初始化 Swow 运行时。
  2. 主协程内注册监听与业务协程,单进程内并发处理请求。
  3. 需要多核利用时,启动多个相同进程实例,由前置负载均衡分发。
  4. 进程监控、重启、日志归集交给部署体系。

代码或图示

# 部署形态示意(非 Swow 配置文件)
supervisor / systemd / 容器编排
  ├── swow-worker 进程 1(主协程 + 业务协程池)
  ├── swow-worker 进程 2
  └── swow-worker 进程 N

常见误区

  • 以为 Swow 必须配多进程模块:单进程多协程即可并发,多进程是水平扩展手段而非运行时强制要求。
  • 把协程当线程使用:协程在单线程内协作调度,不绑定 OS 线程。

追问

  • Swow 是否提供线程能力?答:命名空间下存在 Swow\Thread、Swow\ThreadManager 类;适用边界与 API 细节待确认,需对照官方 API 文档。
  • 多进程间如何共享数据?答:不能直接共享进程内存,需走 Redis、数据库、消息队列或共享内存组件;具体组件见后续批次。

06.5.7.1-008 Swow 与 PHP-FPM 的运行模型差异是什么?

一句话结论

FPM 是“请求驱动短生命周期”:进程随请求创建与销毁,局部变量天然不跨请求;Swow 是“常驻内存 + 协程并发”:进程引导一次后长期驻留,请求态数据必须按协程隔离管理。

概念解释

FPM 下每个请求重新执行框架引导,结束后内存与对象回收;Swow 进程内类、单例、静态属性长期存活,多个协程共享进程内存。这带来性能收益的同时,也要求开发者把请求数据放进协程私有上下文,不能挂在全局或单例属性上。

原理流程

  1. FPM:请求到达 → 拉起进程 → 引导框架 → 执行 → 销毁进程与内存。
  2. Swow:进程启动一次 → 运行时与单例常驻 → 每请求在独立协程内执行 → 协程结束回收私有状态,进程继续服务。
  3. 并发扩展:FPM 靠多进程;Swow 单进程靠协程,再配合多实例水平扩展。

代码或图示

<?php
// 错误示范(文档示例):单例属性存放请求态数据,协程间会互相污染
class OrderService
{
    private int $userId = 0; // 禁止:请求态字段挂在常驻单例上

    public function setUser(int $userId): void
    {
        $this->userId = $userId;
    }
}

常见误区

  • 用 FPM 习惯写常驻服务:请求结束不清理单例状态,下一个协程读到残留数据。
  • 以为协程退出会自动销毁进程内单例:单例生命周期跟随进程,不跟随协程。

追问

  • 请求态数据应该放哪里?答:协程局部变量、协程上下文对象或显式传入参数;详见 06.5.7.8。
  • FPM 项目迁移到常驻模型首先改什么?答:梳理全局/静态状态、单例属性、连接复用与一次性初始化逻辑。

06.5.7.1-009 Swow 对 PHP 版本与线程安全模式有什么要求?

一句话结论

扩展包要求 PHP 8.0 及以上(以当前 Packagist 页面与 composer.json 约束为准),同时提供 NTS 与 ZTS 构建支持;本机 PHP 8.5.9 CLI 是否兼容目标版本,需以扩展实际编译与加载结果为准。

概念解释

PHP 版本约束写在 swow/swow 与 swow/swow-extension 的 Composer 元数据中;线程安全(ZTS/NTS)支持情况在扩展包说明中列出。版本号、最低 PHP 版本、是否支持当前最新 PHP 次版本,会随发布更新,不能凭记忆写死,必须以安装时的元数据与 php --ri swow 输出核对。

原理流程

  1. 查看 composer show swow/swow 的 versions 与 requires 字段。
  2. 查看扩展包页面标注的 PHP 版本范围与 ZTS/NTS 支持。
  3. 在目标 PHP 环境编译安装,执行 php --ri swow 确认加载成功。
  4. 若加载失败,对照编译日志检查 PHP 版本、头文件与依赖库。

代码或图示

# 查看扩展是否加载与编译信息(Windows PowerShell 示例)
php -m | Select-String swow
php --ri swow
composer show swow/swow

常见误区

  • 以为支持 PHP 8.0 就一定支持最新次版本:新 PHP 版本可能需要升级扩展版本才能编译通过。
  • 混淆 ZTS 与 NTS:两者编译产物不同,必须与 PHP 安装模式匹配。

追问

  • 本机当前环境如何确认?答:本任务环境为 PHP 8.5.9 CLI,未安装 swoole/swow;兼容结论待实际安装后核对(待确认)。
  • 安装失败先查什么?答:PHP 版本与扩展匹配、编译工具链、依赖库(如 OpenSSL 选项);具体编译选项以扩展安装文档为准。

06.5.7.1-010 Swow 的安装途径有哪些?如何确认扩展已加载?

一句话结论

主要途径为 PIE 安装 swow/swow-extension,或 Composer 引入 swow/swow 后运行 vendor/bin/swow-builder --install 自动编译;加载后通过 php --ri swow 与类存在性检查确认。

概念解释

PIE 是 PHP 官方推荐的扩展安装工具,替代旧的 pecl 流程;Composer 途径会拉取源码并调用内置 builder 完成编译与安装。安装完成后需要在 php.ini 加载扩展(builder 通常会处理,需核对配置)。库层功能类依赖 Composer 自动加载,仅有扩展不代表库类可用。

原理流程

  1. 方式一:pie install swow/swow-extension 编译安装扩展。
  2. 方式二:composer require swow/swow,再执行 vendor/bin/swow-builder --install。
  3. 重启 CLI/服务进程使扩展加载。
  4. 执行 php --ri swow,并尝试反射 Swow\Coroutine 类确认类已注册。

代码或图示

# 安装与校验命令示例(实际执行结果以本机环境为准,待确认)
composer require swow/swow
vendor/bin/swow-builder --install
php --ri swow

常见误区

  • 只跑 Composer require 不编译扩展:PHP 侧类加载了,底层扩展并未加载。
  • 安装后不校验多 SAPI:CLI 加载成功不代表 FPM/内置服务器等 SAPI 配置了同一份 php.ini。

追问

  • 更新源码后如何重建扩展?答:按安装文档使用 builder 的 rebuild 选项;具体命令参数以 vendor/bin/swow-builder 帮助输出为准(待确认)。
  • 如何区分扩展类与库类缺失?答:反射报“类未找到”时先查 php -m 是否含 swow,再查 Composer 自动加载是否生成。

06.5.7.1-011 Swow 与 Zend 引擎、OPcache 的关系是什么?

一句话结论

Swow 扩展运行在 Zend 引擎之上,协程栈切换、IO hook 等能力通过扩展钩子介入引擎执行流程;OPcache 缓存编译后 opcode,与 Swow 不冲突,但协程切换行为发生在 opcode 执行期,不改变 OPcache 的缓存对象。

概念解释

Zend 引擎负责解析、编译与执行 PHP 代码;扩展通过注册类、钩子、底层函数介入。Swow 把阻塞 IO 调用 hook 到协程调度路径,在等待 IO 时让出当前协程。OPcache 缓存脚本的 opcode 与编译产物,减少重复编译;常驻内存场景下 OPcache 仍按其规则工作,协程上下文与 opcode 缓存是两个层面的事。

原理流程

  1. PHP 脚本编译为 opcode,OPcache 命中则直接复用。
  2. 执行到被 hook 的阻塞 IO 函数时,Swow 调度器挂起当前协程并切到其他协程。
  3. IO 就绪后调度器恢复原协程继续执行后续 opcode。
  4. OPcache 不感知协程切换,只负责 opcode 复用。

代码或图示

# 查看 OPcache 与 swow 是否同时加载
php -m | Select-String opcache
php --ri swow
php --ri opcache

常见误区

  • 以为开了协程就不需要 OPcache:常驻内存仍有编译与文件读取成本,OPcache 作用不变。
  • 以为协程栈会被 OPcache 缓存:OPcache 缓存 opcode,不缓存协程运行时栈。

追问

  • hook 发生在编译期还是运行期?答:阻塞函数在运行期被调用时介入调度;具体 hook 实现细节待确认,以扩展源码与官方文档为准。
  • 调试类扩展与 Swow 共存注意什么?答:需确认调试扩展对协程栈回溯的支持情况,避免回溯信息错乱;具体兼容性待确认。

06.5.7.1-012 Swow 的协程栈与进程内存模型有什么特点?

一句话结论

每个协程拥有独立栈上下文用于保存局部变量与执行帧,协程间共享进程堆内存;栈内存随协程创建分配、退出回收,进程内常驻对象与单例不随协程退出销毁。

概念解释

协程切换时保存当前执行帧与局部变量到自身栈,恢复目标协程栈继续执行。PHP 变量本身存放在 Zend 堆中,协程栈保存的是执行上下文与变量引用。由于单进程多协程共享内存,跨协程读写同一可变对象需要同步或通过 Channel 传递,不能依赖“各有各的内存”。

原理流程

  1. Coroutine::run() 分配协程结构体与栈空间,进入协程体执行。
  2. 让出时保存当前栈帧,切换到调度器选择的下一就绪协程。
  3. 协程结束,栈与执行上下文回收,堆中对象的释放按 PHP 引用计数规则处理。
  4. 进程级单例、静态变量继续驻留,等待后续协程访问。

代码或图示

<?php
// 文档示例:协程私有局部变量不跨协程;共享对象属性则会互相影响
use Swow\Coroutine;

$shared = new stdClass();
$shared->count = 0;
foreach ([1, 2] as $i) {
    Coroutine::run(static function () use ($shared, $i): void {
        $local = $i; // 协程私有
        $shared->count++; // 跨协程共享,需同步保护
    });
}

常见误区

  • 以为协程有独立堆:协程独立的是执行栈上下文,PHP 堆内存共享。
  • 以为协程退出会析构单例:单例跟随进程生命周期,需手动重置或避免存请求态。

追问

  • 协程栈大小如何配置?答:Swow 是否提供栈大小参数、默认值多少,待确认;核对 API 文档与 php --ri swow 配置项。
  • 栈溢出如何表现?答:通常表现为协程异常或进程错误;具体错误类型与上限待确认,需在隔离环境复现。

06.5.7.1-013 Swow 的开源协议与社区归属如何核实?

一句话结论

开源协议、仓库归属与维护状态应以官方仓库 LICENSE、Packagist 元数据与提交记录为准;本页不凭记忆写死协议名称与组织归属,标注为待确认项。

概念解释

选型合规需要确认许可证是否允许业务使用、是否有 copyleft 约束;社区活跃度要看提交频率、issue 处理与版本发布。Swow 相关仓库包括扩展仓库与库仓库,两者可能分开维护。阅读时区分“官方主线”“镜像 fork”与第三方适配包。

原理流程

  1. 打开 Packagist 页面查看 swow/swow 与 swow/swow-extension 的仓库链接。
  2. 在仓库根目录查看 LICENSE 文件内容,确认协议类型与条款。
  3. 查看 Releases/Tags 与最近提交时间,评估维护节奏。
  4. 记录结论到选型文档,标注核对日期与版本。

代码或图示

# 查看 composer 包元数据(协议、版本、仓库地址以实际输出为准)
composer show swow/swow
composer show swow/swow-extension

常见误区

  • 把博客文章中的协议说法当作当前版本事实:协议与维护者可能随版本变化。
  • 只看 Star 数判断成熟度:issue 响应、发版频率与生产案例更有参考价值。

追问

  • 协议能否用于商业闭源项目?答:需逐条核对 LICENSE 条款;本页不下法律结论,待确认项以仓库 LICENSE 原文为准。
  • 如何区分官方包与第三方包?答:以 Packagist 元数据中的仓库链接与命名空间 Swow\ 对应官方库为准。

06.5.7.1-014 Swow 跨平台支持范围如何确认?

一句话结论

扩展编译依赖操作系统提供的 IO 多路复用与系统调用能力,支持平台范围以扩展包说明、编译文档与 CI 矩阵为准;Windows、macOS、Linux 的可用程度可能不同,需在目标部署系统上实测。

概念解释

协程运行时底层依赖 epoll、kqueue、IOCP 类机制之一,不同平台可 hook 的系统调用与网络行为存在差异。部署目标是 Linux 生产环境时,应以 Linux 上的编译与压测结果为准;开发机是其他平台只能作为本地调试参考。扩展包元数据会标注支持的操作系统与 ZTS/NTS 情况。

原理流程

  1. 查 Packagist 扩展包页面的支持操作系统说明。
  2. 在目标操作系统安装 PHP 与编译工具链,编译扩展。
  3. 运行基础协程、Socket、Channel 用例验证关键路径。
  4. 记录平台、PHP 版本、扩展版本组合与已知限制。

代码或图示

# 本机环境核对(Windows 示例):PHP 版本与已加载扩展
php -v
php -m

常见误区

  • 开发机跑通就认为生产 Linux 可用:平台差异可能导致编译失败或个别 hook 行为不同。
  • 忽视部署架构的 OS 版本:glibc 版本、内核版本会影响扩展编译与运行。

追问

  • 当前任务环境是什么?答:Windows + PowerShell 7,仓库在本地工作目录;生产兼容性结论待 Linux 环境实测(待确认)。
  • 跨平台差异查哪里?答:官方安装文档的平台章节、扩展仓库 issue 与 CI 配置;具体限制以官方说明为准。

06.5.7.1-015 Swow 为什么把网络与服务能力拆成组合式组件,而不是内置大而全的 Server?

一句话结论

组合式设计让协程、Socket、Buffer、Channel、Signal 等基础件独立可测、可替换,服务端逻辑由组件拼装;代价是开箱即用程度低于一体化 Server 框架,上层需要自己或借助框架完成编排。

概念解释

一体化 Server 模型把监听、进程管理、回调注册、协议解析收敛到一个对象;Swow 路线是提供贴近系统调用的基础组件,应用按需组合。好处是核心简单、行为透明,便于理解系统原理;代价是自建 HTTP/RPC 服务时需要处理连接生命周期、协议分帧、异常回收等细节,通常由框架层补齐。

原理流程

  1. 基础组件:Socket 负责连接与读写,Buffer 负责字节缓冲,Channel 负责协程通信。
  2. 应用层:接受连接、读取数据、业务处理、回写响应,自行组织循环与异常分支。
  3. 框架层:把上述流程封装为路由、中间件、控制器编排(后续批次的生态集成主题展开)。
  4. 选型时判断团队需要“底座自由”还是“框架开箱即用”。

代码或图示

组件分层示意
Swow 扩展:调度器 / 协程栈 / IO hook / 系统调用封装
  ↓
Swow 库:Socket / Buffer / Channel / Sync / Signal / Mutex
  ↓
框架层:路由 / 中间件 / 容器 / ORM / 连接池
  ↓
业务代码

常见误区

  • 以为组件少就是功能弱:复杂服务由基础件组合而成,不能按类数量判断能力。
  • 误以为自建服务不需要处理资源回收:连接、缓冲区、协程都需要显式或通过 defer 管理生命周期。

追问

  • 协议解析放在哪一层?答:通常在应用或框架层基于 Buffer/Socket 完成分帧与反序列化。
  • 与 Swoole Server 对照时看什么?答:连接回调模型、进程模型、协议内置程度;Swoole 细节不在本章节展开。

06.5.7.1-016 裸用 Swow 底层 API 与基于框架使用的分工是什么?

一句话结论

裸用底层 API 适合理解机制、编写组件与高性能定制场景;项目落地通常借助兼容 Swow 的框架或自研封装,由框架负责引导、容器、路由、连接池与异常处理,业务代码尽量不直接操作调度原语。

概念解释

Coroutine、Channel、Buffer、Socket 是底层原语,直接使用需要自行处理生命周期、同步与错误传播;框架在其上提供请求生命周期管理、依赖注入、配置加载、可观测性集成。面试中应能区分:哪些能力来自 Swow 运行时,哪些来自框架封装,避免把框架行为记到扩展头上。

原理流程

  1. 识别需求层级:并发控制、通信、缓冲属于运行时;路由、容器、ORM 属于框架。
  2. 新项目优先评估已有框架的 Swow 适配情况,避免重复造轮子。
  3. 自研组件时再直接使用底层 API,并补齐异常、超时与回收逻辑。
  4. 文档中标注能力归属层,便于排障定位。

代码或图示

<?php
// 文档示例:业务代码一般通过框架获取请求对象,而不是直接操作 Socket
use Swow\Coroutine;

Coroutine::run(static function (): void {
    // 框架在此协程内完成请求绑定、中间件与控制器调用
});

常见误区

  • 在业务控制器里直接 yield/resume 调度协程:多数业务场景应使用 Channel/Sync 等高层同步设施,而非裸调度 API。
  • 把框架提供的上下文、连接池当成 Swow 原生能力:需核对类名所属命名空间与来源包。

追问

  • 哪些 Swow 类属于扩展/库层?答:Swow\ 命名空间下的类来自扩展与 swow/swow 库;框架自有类在其自身命名空间。
  • 框架适配情况怎么查?答:查框架文档的运行时要求与 Composer 依赖中是否包含 swow 相关包(待确认)。

06.5.7.1-017 Swow 与 Swoole 在抽象层级上的对照关系是什么?

一句话结论

两者都提供协程运行时,但 Swow 的对照重心是“协程对象 + 基础组件”,Swoole 的对照重心是“Server/Client/Task/Timer 一体化 API”;同名概念(Channel、WaitGroup、协程)在命名空间、方法签名与错误语义上需逐一映射。

概念解释

对照时建立三层映射:运行时层(协程、调度、hook)、通信同步层(Channel、WaitGroup、锁)、服务端层(Socket/Server、进程、定时器)。Swow 侧很多服务端能力落在库层组件,Swoole 侧可能是扩展内置对象。迁移对照不能按类名相似度直接替换,必须核对方法签名、阻塞语义、超时单位与异常类型。

原理流程

  1. 列出现有 Swoole 代码使用的全部类与函数。
  2. 按运行时/通信同步/服务端三层归类。
  3. 在 Swow API 文档中找对应组件,核对签名与语义。
  4. 对无直接对应的能力,标注自研封装或生态包缺口。

代码或图示

对照维度示例
协程创建:Swoole go()/Coroutine::run()  ↔  Swow Coroutine::run()
通信通道:Swoole\Coroutine\Channel      ↔  Swow\Channel
同步等待:Coroutine\WaitGroup            ↔  Swow\Sync\WaitGroup

常见误区

  • 看到 Channel 同名就假设行为一致:容量、关闭语义、异常码、超时单位都可能不同。
  • 把 Swoole 的全局函数别名迁移到 Swow:Swow 以命名空间类为主,过程式别名情况待确认。

追问

  • 详细机制差异在哪一页?答:见 06.5.7.2 与 06.5.7.11(迁移对照后续批次)。
  • 对照结论如何留痕?答:以表格记录“原 API → Swow 对应 → 差异点 → 待实测项”,避免口头经验化。

06.5.7.1-018 选型 Swow 前需要在工程上确认哪些前置问题?

一句话结论

选型前需确认 PHP 版本与编译环境、扩展安装可行性、框架与组件生态适配、现有代码的协程安全改造量、团队排障手段与压测验证计划;任一关键项不满足都应先做验证原型再铺开。

概念解释

前置问题分四类:环境可行性(PHP 版本、OS、编译依赖)、生态兼容性(框架、ORM、缓存、队列、追踪)、代码改造量(全局状态、连接复用、阻塞调用)、运维排障(协程观测、日志、监控、灰度回退)。建议先在隔离环境跑通最小服务与关键下游调用,再评估全量迁移。

原理流程

  1. 环境核对:php -v、OS 版本、编译工具链,尝试安装扩展。
  2. 生态盘点:列出依赖包及其协程适配情况。
  3. 代码盘点:全局变量、静态属性、单例请求态、长生命周期连接。
  4. 原型验证:最小 HTTP/RPC 服务 + 数据库/缓存调用,压测并观察挂起与内存。
  5. 输出选型结论:推荐、暂缓或排除,附风险与待确认项。

代码或图示

# 环境信息采集示例(Windows PowerShell)
php -v
php -m
composer show | Select-String swow

常见误区

  • 跳过原型直接全量切换:协程问题往往在并发与长尾请求下才暴露。
  • 只验证启动成功:必须覆盖真实下游调用、超时路径与异常路径。

追问

  • 选型结论需要保留哪些证据?答:环境版本清单、压测数据、问题记录与待确认项;不要只写“可用/不可用”的口头结论。
  • 回退方案如何准备?答:保留原运行时部署形态与配置切换路径,灰度期间可快速回退。

06.5.7.1-019 Swow 在常驻内存模型下,对业务代码提出了哪些基本要求?

一句话结论

业务必须按协程隔离管理请求态数据,避免在全局/静态/单例上保存请求字段;连接与资源按归属使用并显式回收;阻塞调用优先使用被 hook 或协程安全的客户端;异常路径要保证资源释放。

概念解释

常驻内存放大了状态生命周期问题:FPM 请求结束自动清零的东西,在 Swow 进程里长期存在。基本纪律包括:请求数据进协程局部上下文;共享可变状态加同步或走 Channel;连接从池借还或明确归属;用 defer/finally 做清理;不把一次性请求判断写进静态初始化。

原理流程

  1. 启动阶段只做进程级一次性初始化:配置、日志器、连接池。
  2. 请求进入协程后,数据仅存局部变量或协程上下文对象。
  3. 共享资源访问按规则同步,跨协程传值走 Channel。
  4. 退出路径统一清理:关闭句柄、归还连接、复位非线程安全对象。

代码或图示

<?php
// 文档示例:请求数据通过参数/局部对象传递,不写入单例属性
function handle(int $userId, array $payload): array
{
    $requestContext = ['uid' => $userId, 'payload' => $payload];
    // 在协程内使用 $requestContext,结束后随协程回收
    return ['ok' => true, 'uid' => $requestContext['uid']];
}

常见误区

  • 在构造函数或静态初始化里读请求参数:启动阶段没有请求上下文。
  • 复用未重置的对象:数组、缓冲区、计数器复用时必须清空到初始状态。

追问

  • 协程安全细节在哪一页?答:见 06.5.7.8 协程安全与状态管理。
  • 连接池属于运行时能力还是框架能力?答:多为框架/组件层实现;Swow 底层提供 Socket 与同步原语。

06.5.7.1-020 如何阅读 Swow 官方资料并区分扩展能力与库层能力?

一句话结论

以官方 API 文档的命名空间分类、类归属与 Packagist 包元数据为准区分扩展能力与库层能力;阅读顺序建议先跑通协程与同步设施,再进入 Socket/Buffer 等组件,最后对照框架集成。

概念解释

API 文档中 Swow\ 根命名空间下的类由扩展与库共同提供;文档页面会标注方法签名、抛错类型与参数语义。学习时区分三类信息:稳定 API 签名、版本相关行为、待实测结论。博客与教程基于特定版本编写,版本行为可能变化,关键结论要回到当前版本文档核对。

原理流程

  1. 查 Packagist 确认安装的 swow/swow 与扩展版本。
  2. 在 API 文档按命名空间定位类,阅读方法签名与异常说明。
  3. 对照源码或反射确认类是否存在、方法是否可用。
  4. 把不确定项列入「待确认」,写明验证命令与核对位置。

代码或图示

# 版本与加载状态核对(待实际环境执行)
composer show swow/swow
php --ri swow
php -r "var_dump(class_exists('Swow\\Coroutine'));"

常见误区

  • 把旧版本博客的 API 当作当前版本行为:版本演进可能调整签名与默认值。
  • 混淆文档示例与可运行结论:本仓库代码片段均为文档示例,本机未安装扩展,不声称实测输出。

追问

  • 待确认项如何闭环?答:在目标环境执行 php --ri swow、反射类方法、对照官方 API 文档后更新结论。
  • 后续批次覆盖哪些主题?答:Server 与网络编程、错误处理、迁移对照、生态兼容、调试观测、版本演进与选型建议,见章节 index 规划清单。