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

06.5.4.10 Octane 与常驻内存

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

覆盖范围

  • Octane 与 Swoole / RoadRunner / FrankenPHP 运行时的关系
  • worker 常驻带来的状态残留与请求作用域重置
  • 内存泄漏排查、连接复用与重连
  • 与队列、定时任务的协作、部署模型与热重载

FPM 请求模型与调优见 06.5.1.5 FPM 调优与部署;本页聚焦常驻运行时的隔离与运维问题。

06.5.4.10-001 Laravel Octane 定位是什么,与 Swoole/RoadRunner 是什么关系?

一句话结论

Octane 是 Laravel 的常驻内存运行时兼容层:应用引导一次后由 worker 复用,底层可跑在 Swoole、RoadRunner 或 FrankenPHP 等高性能运行时之上;Octane 负责容器重置、请求注入与生命周期事件,运行时负责协程/进程调度与 HTTP 服务。

概念解释

FPM 每个请求重建应用实例;Octane 模式下应用内核与容器在 worker 内常驻,请求对象按次重建。运行时提供进程管理、并发接收与协程能力,Octane 提供框架级的状态隔离钩子。

原理流程

  1. 安装 Octane 并选择运行时(Swoole/RoadRunner/FrankenPHP)。
  2. octane:start 启动常驻 worker。
  3. worker 内引导应用一次。
  4. 每个到达请求重置请求作用域、注入 Request、分发响应、清理状态。

代码或图示

# 安装与启动(命令参数以当前版本 Octane 文档为准)
php artisan octane:install --server=swoole
php artisan octane:start --workers=4 --port=8000

常见误区

  • 把 Octane 当成独立框架:它是 Laravel 的运行时适配层,应用代码仍是标准 Laravel。
  • 认为换 Octane 就自动解决所有性能问题:状态残留、连接泄漏等问题会在常驻模式下放大,需要代码配合。

追问

  • FrankenPHP 与 Swoole 路线差异?答:FrankenPHP 嵌入 PHP 常驻运行,Swoole 提供协程与扩展能力;具体支持版本、协程行为以当前 Octane 版本文档为准,标注待确认后核对官方说明。
  • 本地开发用什么模式?答:可在本地以 Octane 运行时验证常驻问题;无运行时扩展时回退 FPM 开发,避免生产问题只在常驻环境暴露。

06.5.4.10-002 常驻内存与 FPM 请求模型的核心差异是什么?

一句话结论

FPM 每个请求独立进程,请求结束内存全部释放;Octane worker 进程常驻,容器、单例、静态变量与扩展资源跨请求保留,请求之间必须显式隔离状态,否则出现串数据与内存增长。

概念解释

差异不只在性能:FPM 下“请求结束即清空”的隐式保障在常驻模式不存在。容器单例缓存、全局数组、静态属性、长连接都成为跨请求共享的进程级状态。

原理流程

  1. FPM:进程启动 → 引导 → 处理请求 → 进程回收,状态不跨请求。
  2. Octane:worker 启动 → 引导一次 → 循环处理 N 个请求。
  3. 请求开始:重建 Request、重置作用域绑定。
  4. 请求结束:清理请求级状态,进程与单例保留进入下一请求。

代码或图示

// 风险:进程级静态属性跨请求残留
class RequestContext
{
    public static ?User $current = null;
}
// 常驻下上一请求用户会被下一请求读到;应通过 scoped 绑定或方法传参传递

常见误区

  • 沿用 FPM 经验认为“请求结束对象就没了”:常驻下单例与静态状态不会自动消失。
  • 在常驻进程里依赖请求结束时的析构做清理:对象生命周期与请求边界不再对应。

追问

  • 哪些状态必须按请求隔离?答:当前用户、请求输入、会话、模型临时快照、请求级服务实例;进程级可复用的是只读配置、轻量工具、连接池。
  • 如何快速识别一段代码是否有常驻风险?答:检查静态属性、容器单例中的可变属性、全局/类静态数组与缓存对象引用。

06.5.4.10-003 worker 常驻后哪些状态容易残留?

一句话结论

易残留的有容器单例的可变属性、静态属性与静态数组、全局变量、构造时缓存的请求数据、扩展连接对象;这些在 FPM 下随进程销毁,常驻下会进入下一请求。

概念解释

残留来源分三类:容器缓存的单例对象状态、PHP 静态与全局状态、底层扩展持有资源。排查时沿“哪些对象在 worker 启动后只构造一次”逐个检查其可变字段。

原理流程

  1. 列出单例绑定与静态类。
  2. 检查其属性是否被请求方法改写。
  3. 核对改写值是否来自当前请求。
  4. 请求结束后这些属性未清空即残留到下一请求。

代码或图示

// 反例:单例缓存当前请求用户
class SessionHolder
{
    public ?User $user = null;
}
// 修复:用户从 Request 或 scoped 服务取,不写入进程级单例属性
public function handle(Request $request, SessionContext $context): void
{
    $context->setUser($request->user());
}

常见误区

  • 以为把服务改成 bind 就解决:进程内短生命周期对象若被单例持有引用,状态仍随单例残留。
  • 在服务提供者 boot 阶段缓存请求相关数据:boot 只执行一次,拿不到任何一次具体请求。

追问

  • Facade 背后的单例也会残留吗?答:Facade 访问的底层实例通常是容器单例,其内部可变状态同样跨请求;与 06.5.4.3 Facade 与契约 Contracts 衔接理解。
  • 框架自身如何处理核心状态?答:请求对象、会话等按请求重建;应用引导产物(配置、路由、容器绑定规则)属于进程级复用,不应被请求代码改写。

06.5.4.10-004 Octane 如何在请求边界重置容器与请求作用域?

一句话结论

Octane 在每个请求开始/结束时重置请求级作用域缓存、重新绑定 Request 实例,并调用容器的作用域清理钩子;请求级单例(scoped)在作用域结束后被清除,进程级 singleton 仍保留。

概念解释

重置机制保证请求对象与请求级服务不跨请求复用;是否清空全部单例实例以当前版本 Octane 实现为准(待确认),需要核对 FlushState / 重置相关监听器源码。

原理流程

  1. 请求进入,Octane 构造新的 Request 并替换容器中的请求实例。
  2. 重置当前作用域,清除 scoped 绑定缓存。
  3. 走正常路由分发。
  4. 请求结束,清理请求级状态,保留进程级单例与配置。

代码或图示

// 推荐:请求级服务使用 scoped 绑定,随作用域重置
$this->app->scoped(UserContext::class, function ($app) {
    return new UserContext($app['request']->user());
});

常见误区

  • 把请求级服务绑成 singleton 再指望框架自动清空:进程级单例不随作用域重置清空。
  • 认为 Octane 每次请求重建整个容器:引导产物复用,只重置请求作用域与相关状态。

追问

  • 自定义进程级状态在哪里清理?答:通过 Octane 请求生命周期监听器(请求开始/结束钩子)登记清理逻辑;钩子类名与注册位置以当前版本 Octane 文档为准。
  • 测试如何验证作用域已重置?答:在两个模拟请求后解析同一 scoped 服务,对比实例是否为新对象;单例则应保持同一实例。

06.5.4.10-005 单例服务持有请求状态在常驻下会造成什么后果?

一句话结论

单例属性缓存当前用户、输入或模型后,下一请求复用同一实例会读到上一请求的数据,造成越权读取、串号、错误通知;严重时缓存脏状态影响整个 worker 处理的所有后续请求。

概念解释

FPM 下单例只服务一次请求,问题不明显;常驻下单例成为跨请求共享对象。请求数据应作为方法参数传递,或存入 scoped 服务,不写进进程级单例的可变字段。

原理流程

  1. 请求 A 在单例属性写入用户 A。
  2. worker 处理请求 B 时单例未重建。
  3. 请求 B 读取到用户 A 的残留数据。
  4. 产生串号、越权或错误业务结果。

代码或图示

// 反例
class PaymentService
{
    public ?User $currentPayer = null;
}
// 修复:方法签名显式接收付款方
public function charge(User $payer, Order $order): Receipt
{
    // 使用参数 $payer,不依赖实例属性
}

常见误区

  • 给单例加个“请求结束清空”的补丁而不改绑定:清空时机遗漏时仍残留,应从生命周期归属上纠正。
  • 只看控制器链路:服务间互相传递的单例引用同样可能携带残留状态。

追问

  • 如何在代码评审中发现这类问题?答:检查单例/静态类的 public 可变属性与请求相关赋值;请求上下文只允许出现在参数或 scoped 对象中。
  • 数据库模型会被单例缓存污染吗?答:模型实例本身不跨请求缓存,但被单例持有的模型引用会残留;需要在单例中持有模型时只保存标识字段,使用时重新加载。

06.5.4.10-006 常驻内存下数据库与 Redis 连接如何处理断开重连?

一句话结论

常驻进程复用数据库/Redis 连接,连接可能被中间件空闲断开;需要在每次使用前检测有效性,或依赖框架/驱动的重连机制,不能假设进程内连接永久有效。

概念解释

FPM 每请求新建连接,常驻下连接长期挂起。MySQL wait_timeout、Redis 空闲断连、网络抖动都会让复用连接失效;驱动是否自动重连、重试次数以当前版本数据库/Redis 客户端实现为准(待确认)。

原理流程

  1. worker 引导时建立连接并放入连接池/单例。
  2. 多个请求复用该连接。
  3. 中间件回收空闲连接后,旧连接失效。
  4. 下一次操作前检测或捕获断连异常,重建连接重试。

代码或图示

// 定期重连示例:在任务/请求钩子中校验连接状态
use Illuminate\Support\Facades\DB;

if (! DB::connection()->getPdo()) {
    DB::reconnect();
}

常见误区

  • 把连接对象存进任务属性或静态变量长期持有:连接失效后反序列化/复用都会出错。
  • 断连异常不重试直接失败:瞬时断连应在可控范围内重连一次,再上报失败。

追问

  • 连接池大小如何规划?答:按 worker 进程数乘以每进程连接数对照数据库最大连接数规划;常驻下连接不再每请求新建,总占用比 FPM 模型稳定但需上限控制。
  • Octane 与队列 worker 的连接策略一样吗?答:都是常驻复用思路;队列 worker 每任务之间是否重建连接以队列实现为准,排查时分别核对。

06.5.4.10-007 如何排查常驻进程的内存泄漏?

一句话结论

先观察 worker 内存曲线是否单调上涨,定位是请求间残留对象、缓存无限增长还是扩展资源未释放;手段包括内存快照、单请求前后对比、周期性重启 worker 兜底,以及检查静态数组与单例缓存的清理逻辑。

概念解释

泄漏不一定是 PHP 传统意义的未释放内存,更多是“跨请求累积的引用与缓存”。排查基线:连续处理相同请求多次,对比 memory_get_usage,找出每请求后无法回收的对象。

原理流程

  1. 记录每个请求结束后的内存占用,绘制趋势。
  2. 复现:构造固定请求循环执行 N 次。
  3. 对比两次请求间存活对象,定位累积的数组/单例/静态属性。
  4. 修复引用释放;短期用 --max-requests 类上限让 worker 定期重启兜底。

代码或图示

// 请求钩子中记录内存基线(示例,钩子注册以 Octane 文档为准)
use Illuminate\Support\Facades\Log;

Log::info('memory', [
    'usage' => memory_get_usage(true),
    'peak' => memory_get_peak_usage(true),
]);

常见误区

  • 内存一涨就归因于 PHP 泄漏:先确认是业务缓存有意保留还是无界增长,缓存应有 TTL 与上限。
  • 只看峰值不看回收后基线:峰值高可能是单请求大对象,基线持续上涨才是跨请求泄漏。

追问

  • 哪些扩展容易累积资源?答:图像处理、PDF 生成、外部连接句柄等;使用后显式释放,具体扩展行为以对应扩展文档为准。
  • worker 定期重启参数是什么?答:Octane/队列 worker 通常提供最大请求数或内存上限参数,达到后退出由进程管理器拉起;参数名以当前版本命令帮助为准(待确认)。

06.5.4.10-008 Octane 的生命周期事件有哪些可挂接点?

一句话结论

Octane 提供 worker 启动、请求进入、请求处理完成、worker 停止等生命周期钩子,用于做连接预热、请求级清理、指标记录;钩子在常驻边界触发,不能在 worker 启动钩子里读取单次请求数据。

概念解释

生命周期监听器是常驻状态管理的入口:workerStart 做一次性重资源初始化,RequestReceived/RequestHandled 做请求边界的记录与清理,WorkerStopping 释放持久资源。钩子类名与注册方式以当前版本 Octane 文档为准(待确认)。

原理流程

  1. worker 启动触发启动钩子:建立连接、预热只读缓存。
  2. 每个请求进入触发请求开始钩子。
  3. 请求结束触发完成钩子:记录指标、清理请求级残留。
  4. worker 停止触发收尾钩子:释放持久资源。

代码或图示

// 示意:请求结束后记录耗时与内存(实际钩子接口以 Octane 文档为准)
public function onRequestHandled($request, $response): void
{
    logger()->info('octane request', [
        'path' => $request->path(),
        'memory' => memory_get_usage(true),
    ]);
}

常见误区

  • 在 worker 启动钩子里取当前登录用户:启动时不存在请求上下文。
  • 在请求完成钩子里做阻塞重活:会拖慢下一个请求的处理节奏。

追问

  • 监听器如何注册?答:在 Octane 配置或服务提供者中登记生命周期回调;具体配置键名以版本发布的 config/octane.php 为准。
  • 钩子异常会影响请求吗?答:请求边界钩子抛错可能污染后续请求,清理逻辑应包裹异常处理并降级记录。

06.5.4.10-009 Octane 模式下的容器解析与 FPM 有何不同?

一句话结论

解析协议一致(构造注入、方法注入、scoped/singleton 语义相同),差别在生命周期:容器实例常驻,singleton 跨请求保留,scoped 按请求作用域重置;FPM 下整个容器随进程销毁。

概念解释

与 06.5.4.1 服务容器与绑定解析 的绑定语义对照:常驻模式把绑定生命周期差异放大,选择 scoped 还是 singleton 必须考虑状态归属。

原理流程

  1. worker 内容器只构造一次。
  2. singleton 首次解析后常驻缓存。
  3. scoped 在请求作用域内缓存,出作用域清除。
  4. 请求结束容器规则保留,请求级缓存清除。

代码或图示

// 进程级复用:只读配置/轻量策略
$this->app->singleton(ExportFormatter::class, CsvFormatter::class);

// 请求级隔离:携带当前请求上下文
$this->app->scoped(RequestContext::class, fn ($app) => new RequestContext($app['request']));

常见误区

  • 不区分生命周期全绑 singleton:请求态服务残留;全绑 bind 又失去常驻复用收益。
  • 在 Octane 下手动 flush 容器:会清掉进程级单例与引导产物,造成反复重建,不应在请求路径中调用。

追问

  • 队列任务在 Octane worker 内解析容器吗?答:队列消费是否复用 Octane 进程取决于部署方式;独立队列 worker 各自引导应用,作用域按任务划分,详见本页与队列页衔接。
  • 如何复核某个服务是 singleton 还是 scoped?答:查服务提供者绑定调用,并在两个请求后对比解析实例引用是否相同。

06.5.4.10-010 Octane 与队列任务如何协作?

一句话结论

队列任务通常由独立的 worker 进程(queue:work 或 Horizon)消费,不占用 Octane Web worker;Octane 负责 HTTP 请求,队列消费各自常驻,二者共享代码库与配置,但进程与内存相互隔离。

概念解释

把重异步任务放在独立队列进程可以避免拖慢 Web 响应;Octane worker 不承担任务消费时,任务生命周期、连接重连按队列 worker 自身规则处理。是否支持在 Octane 进程内跑队列消费者以当前版本文档为准(待确认)。

原理流程

  1. Web 请求经 Octane worker 处理并投递任务。
  2. 队列消息进入中间件。
  3. 独立队列 worker 拉取任务执行。
  4. 两类进程分别监控内存、积压与失败。

代码或图示

// 请求内投递,不阻塞响应
ProcessReport::dispatch($report)
    ->onQueue('reports');

# 队列进程独立部署,与 octane:start 分开管理
# php artisan horizon
# php artisan queue:work redis --queue=reports

常见误区

  • 在 Octane Web worker 内同步执行重任务:阻塞协程/进程,影响并发请求。
  • 让队列任务依赖 Octane 的请求状态:队列进程无 HTTP 请求上下文。

追问

  • 队列 worker 也需要常驻隔离检查吗?答:需要,队列 worker 同样常驻复用容器,单例状态跨任务残留的排查思路与 Web worker 一致。
  • 两类进程如何分配资源?答:按 Web 延迟目标与队列吞吐分别规划副本、内存上限与下游连接配额。

06.5.4.10-011 Octane 下定时任务调度如何部署?

一句话结论

调度器仍由系统 cron 每分钟触发 schedule:run,或使用常驻调度进程;调度任务本身可投递到队列异步执行,不要求在 Octane Web 进程内跑定时逻辑。

概念解释

Octane 解决的是 Web 请求常驻,调度触发机制与 06.5.4.12 Artisan 命令与调度任务 一致;多实例部署时调度仍需防重复执行。

原理流程

  1. 宿主机 cron 每分钟调用 schedule:run。
  2. 调度器到期匹配任务,可直接执行或投递队列。
  3. 队列任务由独立 worker 消费。
  4. 多实例下用互斥锁保证单实例执行。

代码或图示

// 调度定义:重任务入队,调度进程只做触发
$schedule->job(new CleanExpiredCart)->daily()->withoutOverlapping();

常见误区

  • 把定时循环写进 Octane worker 启动钩子:进程模型与调度器语义不符,多副本下重复执行。
  • 调度任务在 Web 进程上下文执行:阻塞请求处理线程。

追问

  • 常驻调度进程是什么?答:部分版本提供常驻监听调度的命令以替代每分钟 cron;命令名与支持情况以当前版本文档为准(待确认)。
  • Octane 重启会不会漏掉调度?答:调度由独立 cron/常驻调度进程驱动,Web 进程重启不影响到点触发。

06.5.4.10-012 本地开发与部署时的热重载机制是什么?

一句话结论

开发模式可用文件监视触发热重载(监视配置、视图与代码变更后重启 worker);生产部署应滚动重启 Octane 进程,不依赖文件监视,避免每请求扫描文件带来的开销。

概念解释

常驻进程不会自动加载新代码,代码变更必须重启 worker。开发环境的 watch 模式降低反馈成本;生产发布通过进程管理器重启或滚动替换容器完成代码切换。

原理流程

  1. 开发:启动时开启 watch,文件变更触发 worker 重启。
  2. 发布:部署新代码后停止旧 worker、拉起新 worker。
  3. 进程管理器保证重启期间服务可用(多副本滚动)。
  4. 生产关闭 watch 与调试工具。

代码或图示

# 开发监视模式(参数名以当前版本为准)
php artisan octane:start --watch

# 生产重启:由 systemd/容器编排执行重载
php artisan octane:reload

常见误区

  • 生产开启 --watch:文件扫描与频繁重启增加不稳定因素。
  • 单副本直接重启:重启窗口内请求中断,生产应多副本滚动。

追问

  • 配置文件改了需要重启吗?答:常驻进程在启动时读取配置,配置变更同样需要重载进程;config:clear 不影响已常驻进程的内存配置。
  • 视图模板会随请求重新编译吗?答:视图编译产物按请求加载的部分可更新;PHP 代码与容器绑定变更必须重启 worker。

06.5.4.10-013 worker 进程数与并发能力如何规划?

一句话结论

worker 进程数按 CPU 核数、单请求阻塞比例与内存上限规划;Swoole 等协程运行时可在进程内并发协程,RoadRunner 模型以进程并发为主。并发上限同时受下游数据库与外部接口连接数约束。

概念解释

进程数不是越大越好:过多 worker 争抢 CPU 与下游连接,上下文切换加剧。基准是压测不同进程数下的响应时间、吞吐与错误率,找到稳定拐点。

原理流程

  1. 估算单请求 CPU 耗时与等待(IO)占比。
  2. 按核数设定初始 worker 数量。
  3. 压测观察 CPU、内存、下游连接与响应分布。
  4. 按瓶颈调整副本与队列隔离。

代码或图示

# 启动参数示例:worker 数与请求上限以压测结果为准
php artisan octane:start --workers=4 --max-requests=500

常见误区

  • 按访问量盲目堆 worker:下游数据库连接先打满,整体错误率上升。
  • 忽略内存上限:单 worker 内存 × 进程数决定总内存,需留余量。

追问

  • 协程是否等于无限并发?答:协程降低 IO 等待的进程占用,但仍受运行时调度、连接池与下游限制;阻塞式扩展调用会让出协程能力,具体协程兼容性以 Swoole 扩展文档为准。
  • 单进程最大请求数作用是什么?答:让 worker 处理一定请求后退出重建,兜底内存累积;配合进程管理器拉起新进程。

06.5.4.10-014 从 FPM 迁移到 Octane 需要检查哪些代码?

一句话结论

迁移前静态扫描单例/静态状态、请求上下文使用、连接与资源持有、全局缓存;补充常驻环境测试,重点验证跨请求隔离、连接重连、周期性重启与部署滚动流程。

概念解释

迁移清单覆盖:容器绑定生命周期、请求上下文取值方式、全局/静态可变状态、不可序列化或不可复用对象、测试在常驻模式下的表现。

原理流程

  1. 扫描 singleton 绑定与静态属性中的请求态字段。
  2. 审查控制器/服务中直接取 session、auth、request 的位置。
  3. 检查连接、句柄、大对象的持有与释放。
  4. 在 Octane 模式跑测试与压测,观察内存与串数据问题。

代码或图示

// 迁移检查点示例:请求态通过参数传入服务
public function placeOrder(Request $request, OrderService $service): Response
{
    $validated = $request->validate($rules);
    return $service->create($validated, $request->user());
}

常见误区

  • 只在 FPM 下跑通测试就上 Octane:串数据与泄漏只在常驻复现时暴露。
  • 迁移时一次性重写全部服务:先改高风险请求态单例,压测观察后逐步推进。

追问

  • 哪些框架旧写法在常驻下风险最高?答:依赖请求结束析构清理、静态缓存当前请求数据、全局数组累积;这些在 FPM 下被进程销毁掩盖。
  • 回退方案是什么?答:Octane 作为运行时层,代码可保留 FPM 兼容;出现严重常驻问题时回退 FPM 部署,业务代码不绑定 Octane 专属 API。

06.5.4.10-015 Octane 下的测试与 FPM 行为差异如何处理?

一句话结论

功能测试默认在单次请求隔离环境运行,不一定复现常驻残留;需要额外构造“同一 worker 连续处理多请求”的场景验证状态隔离,单例残留问题只在这种回归测试中容易暴露。

概念解释

PHPUnit/Pest 用例之间通常重建应用容器,接近 FPM 语义;常驻泄漏需要模拟复用容器的连续请求。测试基类与重置行为以当前版本测试框架为准(待确认)。

原理流程

  1. 常规功能测试覆盖单请求行为。
  2. 补充连续请求用例:复用 worker 容器处理两个请求。
  3. 断言第二请求未读到第一请求的用户/输入残留。
  4. 观察内存基线在多轮用例后是否回落。

代码或图示

// 示意:连续两个请求后校验用户上下文隔离
$this->actingAs($userA)->get('/profile');
$this->actingAs($userB)->get('/profile');
// 断言响应属于 $userB,无 $userA 残留字段

常见误区

  • 测试全绿就认为常驻安全:标准测试重建容器,覆盖不到跨请求残留。
  • 在测试中依赖单例缓存的脏状态做断言:掩盖了生命周期设计问题。

追问

  • 测试结束需要手动清单例吗?答:测试基类通常有重置逻辑;自定义绑定的进程级缓存需在用例间显式清理,具体基类行为核对测试文档。
  • 如何在 CI 跑 Octane 兼容检查?答:在 CI 环境安装对应运行时扩展,启动 Octane 跑关键冒烟用例;无扩展时至少做静态扫描。

06.5.4.10-016 常驻进程中的全局缓存与数组要注意什么?

一句话结论

进程内缓存(静态数组、单例属性)只在本 worker 内有效,多副本之间不共享,且容量只增不减时会持续吃内存;应设上限、TTL 或在请求边界清理,跨进程共享状态必须走 Redis 等外部存储。

概念解释

进程内缓存适合只读、可重建的小对象;可变业务状态、计数、锁不能依赖进程内数组,多副本下各 worker 数据不一致。

原理流程

  1. 判断缓存内容是否需要跨进程一致。
  2. 进程内缓存设置条目上限与淘汰策略。
  3. 请求结束清理请求级缓存条目。
  4. 跨副本状态写入共享存储。

代码或图示

// 进程内小缓存:仅限只读字典,带容量上限
private static array $dictionary = [];

public function label(string $code): string
{
    if (! isset(self::$dictionary[$code])) {
        self::$dictionary[$code] = $this->load($code);
    }
    return self::$dictionary[$code];
}

常见误区

  • 用静态数组做分布式锁或计数:多 worker 各算各的,结论错误。
  • 进程缓存无上限:大字典、大模型列表长期累积,内存单调上涨。

追问

  • 进程内缓存与框架缓存 Facade 区别?答:缓存 Facade 默认走 Redis/database 等共享驱动;进程内数组是 PHP 内存结构,不跨进程、不持久化。
  • 配置类数据适合进程内缓存吗?答:只读配置在引导时读取即可;运行期可变配置必须从共享存储或数据库取。

06.5.4.10-017 worker 崩溃或异常退出后如何恢复?

一句话结论

常驻进程需要外部进程管理器(systemd、supervisor、容器编排)监控主进程,异常退出后自动拉起;Octane 内部 supervisor 管理子 worker,但主进程本身的存活依赖外部管理。

概念解释

崩溃来源:内存超限、致命错误、扩展段错误、协程异常未捕获。外部管理器负责重启并保留退出日志;单 worker 崩溃不应影响其他副本,多副本滚动保证可用性。

原理流程

  1. 进程管理器以常驻方式启动 Octane 主进程。
  2. 子 worker 异常退出由内部 supervisor 重建。
  3. 主进程退出被管理器检测到,重新拉起。
  4. 崩溃日志进入系统日志或容器日志,供排查。

代码或图示

# systemd 示意(实际部署按环境填写)
[Unit]
Description=Laravel Octane

[Service]
Type=simple
Restart=always
RestartSec=2
ExecStart=php artisan octane:start --workers=4

常见误区

  • 只靠 nohup 启动:进程退出后无人拉起,崩溃后服务静默不可用。
  • 崩溃后无限快速重启:应加重启间隔与失败计数,避免崩溃循环打满资源。

追问

  • 未捕获异常会让 worker 退出吗?答:框架通常捕获请求异常并返回错误响应;致命错误、扩展错误可能终止进程,需结合运行时错误日志判断。
  • 重启后引导开销多大?答:新 worker 重新执行应用引导与预热,短时间内响应变慢;多副本滚动可避免整体抖动。

06.5.4.10-018 Octane 带来的性能收益来自哪里,代价是什么?

一句话结论

收益主要来自应用引导、服务解析与配置加载只做一次,请求不再重建框架;代价是代码必须满足常驻隔离约束,调试复杂度上升,扩展兼容性与内存规划需要额外验证。

概念解释

基准对比:FPM 每请求完成框架引导、容器构造、中间件装配;Octane 把这些摊到 worker 生命周期。性能提升幅度取决于应用引导成本与请求 CPU/IO 结构,并非所有应用都显著受益。

原理流程

  1. 统计 FPM 单请求引导阶段耗时占比。
  2. Octane 复用引导产物,请求只做参数解析与业务执行。
  3. 常驻隔离与内存约束带来改造成本。
  4. 压测对比响应时间、吞吐与内存占用再决定是否采用。

代码或图示

# 压测对比指标:吞吐、P95/P99 响应、错误率、内存占用
# ab / wrk / 压测平台均可,具体工具链按项目既有基础设施选择

常见误区

  • 宣称 Octane 一定比 FPM 快:IO 密集型应用瓶颈在数据库与外部接口,框架引导占比低,收益有限。
  • 忽略常驻约束的改造成本:遗留代码大量请求态单例时,迁移工作量不容忽视。

追问

  • 哪些应用最适合先尝试?答:引导重、请求短、无大量请求态全局状态的应用;遗留重、状态散落在静态变量中的应用先治理再迁移。
  • 收益如何量化?答:同一负载下对比 FPM 与 Octane 的吞吐、延迟分布与资源占用,以压测数据为准,不凭经验断言。

06.5.4.10-019 常驻运行时下日志与调试信息要注意什么?

一句话结论

日志上下文必须携带请求标识,因为多请求在同一进程内交错;不能依赖进程输出顺序推断请求归属,调试信息中不要残留上一请求的数据,生产环境关闭调试面板与详细堆栈暴露。

概念解释

常驻进程日志是多个请求的混合流,需要 request id 串联;内存调试工具在常驻模式下的快照也会包含历史请求对象,注意区分当前请求与残留引用。

原理流程

  1. 请求开始生成/继承 request id 写入日志上下文。
  2. 业务日志附带该标识与用户标识(脱敏后)。
  3. 请求结束输出处理结果日志。
  4. 按 request id 在混合日志流中串联单次请求链路。

代码或图示

// 日志上下文携带请求标识(中间件中注入)
logger()->info('checkout started', [
    'request_id' => $request->header('X-Request-ID') ?: (string) \Illuminate\Support\Str::uuid(),
    'order' => $order->id,
]);

常见误区

  • 打印“当前用户”到进程级调试缓存:跨请求混在一起难以区分归属。
  • 生产保留 verbose 调试工具:内存与信息暴露风险增加,应按环境开关。

追问

  • 队列任务日志如何关联?答:任务日志携带业务标识与任务 ID;跨 Web 到队列的链路追踪见 06.5.4.15 性能剖析与可观测性。
  • 异常堆栈在常驻下需要额外记录什么?答:记录请求标识、队列/任务标识、worker 进程号,便于在混合日志中定位归属。

06.5.4.10-020 常驻模式下哪些旧代码习惯需要改造?

一句话结论

需要改造的习惯包括:在构造函数或单例中缓存请求数据、用静态变量做请求级存储、每请求假设新建容器、依赖析构清理资源、在业务代码里直接 new 连接句柄;改造方向是状态参数化、绑定生命周期正确化、资源显式管理。

概念解释

这些习惯在 FPM 下被进程销毁机制兜底,常驻下失去兜底。改造原则:能通过参数传递的状态不进实例,能 scoped 的不 singleton,进程级缓存必须可重建且有边界。

原理流程

  1. 梳理业务链路中的状态持有者。
  2. 区分进程级可复用状态与请求级状态。
  3. 请求级状态改为参数或 scoped 服务。
  4. 资源持有改为按需获取、用完释放,连接交由驱动管理。

代码或图示

// 改造前:实例属性记当前请求
class CartService { public ?Cart $current; }

// 改造后:每次方法调用显式传入
public function add(Cart $cart, int $itemId): Cart
{
    $cart->addItem($itemId);
    return $cart;
}

常见误区

  • 把改造等同于全面静态化:常驻不是让所有对象变单例,而是明确各对象的生命周期归属。
  • 改造后缺少回归验证:应在常驻环境连续请求压测,确认无串数据与内存上涨。

追问

  • 第三方包也需要审查吗?答:需要,包内的静态状态、单例请求态同样会残留;选型时确认包对 Octane/常驻运行时的兼容性说明。
  • 改造优先级怎么排?答:先处理认证、支付、多租户等涉及用户数据隔离的链路,再处理缓存与工具类,最后做边缘脚本与命令。