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

04.5.2.14 常驻运行时 FrankenPHP 与 RoadRunner

所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.5 PHP / 04.5.2 PHP 新版本特性与运行时演进

04.5.2.14-001 FPM 请求生命周期与常驻进程模型的根本差异是什么?

一句话结论

FPM 模式下每个请求独立初始化应用、处理完即销毁上下文;常驻模式下 worker 进程长期存活,在进程内循环接收并处理多个请求,应用代码与部分资源在请求间复用。

概念解释

FPM(FastCGI 进程管理器)按请求拉起执行环境:脚本编译、类加载、容器初始化等工作每个请求重复发生;常驻运行时把这些成本摊到多个请求上,进程内保留 OPcache 编译结果、已加载类与初始化好的服务对象。差异也带来状态残留这一常驻模式特有问题。

原理流程

  1. FPM:请求进入 → 初始化执行环境 → 执行脚本 → 响应结束 → 回收上下文。
  2. 常驻:worker 启动一次 → 循环等待任务 → 处理请求 → 清理请求级状态 → 继续下一请求。
  3. 两类模型在进程复用粒度、资源生命周期与状态隔离上形成根本区别。

代码或图示

// 常驻 worker 请求循环骨架(示意,具体协议由运行时实现)
function workerLoop(callable $handler): void {
    while (true) {
        $request = awaitRequest(); // 由运行时提供的等待任务机制
        try {
            $handler($request);
        } catch (Throwable $e) {
            error_log('request failed: ' . $e->getMessage());
        } finally {
            resetRequestState(); // 请求间清理,避免状态残留
        }
    }
}

function resetRequestState(): void {
    // 重置请求级上下文、临时缓存与引用
}

常见误区

  • 以为常驻只是“FPM 不回收进程”:除进程存活外,请求边界的状态管理、资源复用与异常处理都需要重新设计。
  • 把 FPM 的“请求结束即全部销毁”假设带到常驻模式:残留状态会污染后续请求。

追问

  • 常驻模式还需要 FPM 吗?答:不需要,常驻运行时自行管理 worker 进程与请求协议;选型时按运行时形态部署。
  • 两种模型下 OPcache 行为有何差异?答:进程常驻后编译结果在内存中保留更久;具体命中率与配置差异见 04.5.2.8 与本页后续题目。

04.5.2.14-002 常驻运行时解决了 FPM 的哪些痛点?

一句话结论

常驻模式主要消除每请求重复的启动开销:类加载与编译、容器构建、连接初始化等成本被摊薄,从而降低单请求额外耗时、提升吞吐;同时也为长生命周期资源(连接池、后台任务)提供了载体。

概念解释

FPM 每个请求重新进入脚本执行流程,即使有 OPcache 缓存 opcode,应用层初始化(依赖注入容器、配置加载、服务实例化)仍重复执行。常驻进程把这些一次性工作放在启动阶段,请求期直接复用;数据库等连接也可在进程内保持复用。

原理流程

  1. 启动阶段:加载配置、构建容器、初始化可复用资源。
  2. 请求阶段:直接取用已初始化服务,执行业务逻辑。
  3. 复用阶段:连接、类定义、编译结果在进程内保留,跨请求复用。

代码或图示

// 启动期一次性初始化,请求期复用(示意骨架)
$container = buildContainer(); // 启动期构建一次
$sharedConfig = loadConfig();  // 启动期加载一次

function handleRequest(array $input, Container $container): array {
    $service = $container->get(OrderService::class);
    return $service->process($input);
}

class Container {
    private array $services = [];

    public function get(string $id): object {
        return $this->services[$id] ??= $this->create($id);
    }

    private function create(string $id): object {
        return new $id();
    }
}

常见误区

  • 以为常驻一定更快:收益取决于启动成本占比;短平快接口与重初始化应用的收益不同,需压测对比。
  • 复用所有对象:请求级可变对象不能跨请求共享,需区分单例服务与请求对象。

追问

  • 连接复用在常驻模式有什么前提?答:连接必须可重入使用,失效后能重建;请求间不能残留事务或会话状态。
  • 常驻模式对冷启动有影响吗?答:进程启动与预热成本集中在发布/重启阶段,单请求不再承担,但冷启动瞬间延迟升高。

04.5.2.14-003 worker 模式的基本概念是什么?

一句话结论

worker 是常驻运行时中承接任务的执行单元:主进程/管理器负责拉起与监控 worker,worker 在自己的进程内循环处理请求,达到条件后被回收替换。

概念解释

运行时通常由两层构成:管理器负责进程调度、任务分发与健康检查;worker 负责执行 PHP 代码。worker 数量、最大处理任务数、重启策略由运行时配置。每个 worker 隔离自己的内存与状态,单个 worker 出问题不直接影响其他 worker。

原理流程

  1. 管理器按配置拉起若干 worker 进程。
  2. 请求/任务被分发到空闲 worker。
  3. worker 处理完成后回到空闲;达到任务数或异常条件时由管理器回收重启。

代码或图示

// worker 生命周期示意(协议细节以具体运行时文档为准,待确认)
function runWorker(callable $handler, int $maxJobs): void {
    $processed = 0;
    while ($processed < $maxJobs) {
        $task = receiveTask();
        $handler($task);
        $processed++;
    }
    // 达到最大任务数后退出,由管理器拉起新 worker
}

// 管理器视角的 worker 状态:idle / busy / stopped
$workerStates = ['idle', 'busy', 'stopped'];
echo implode(', ', $workerStates), PHP_EOL;

常见误区

  • 以为 worker 数量等于 CPU 核数即可:还需结合任务类型(IO 密集/CPU 密集)、内存占用与压测结果调整。
  • worker 永久不回收:长生命周期进程会累积内存与状态问题,需要任务上限与重启机制。

追问

  • worker 崩溃后谁负责重启?答:管理器监控 worker 退出状态并按策略拉起;具体健康检查与重启参数以运行时配置为准(待确认)。
  • 多个 worker 之间共享什么?答:文件系统、外部缓存与数据库;进程内内存与静态状态不跨 worker 共享。

04.5.2.14-004 状态残留有哪些典型来源?

一句话结论

状态残留来自跨请求未重置的可变状态:静态变量、单例/容器缓存、全局变量、对象属性、复用连接上的事务与会话、缓存的请求数据;它们在 FPM 下随进程销毁,常驻下会带到下一请求。

概念解释

凡是在 worker 生命周期内存活、又随请求变化的状态,都可能成为残留源。典型表现:下一请求读到上一请求的用户身份、旧购物车数据、未提交事务、被污染的单例属性。排查时沿“静态/全局/单例/连接”四类引用向上找。

原理流程

  1. 识别启动期存活的对象与静态存储。
  2. 检查其中哪些属性或缓存会在请求中被写入。
  3. 请求结束前显式重置,或改为请求作用域内创建。

代码或图示

// 反面示例:静态缓存跨请求残留
class SessionCache {
    /** @var array<string, mixed> */
    private static array $data = [];

    public static function set(string $key, mixed $value): void {
        self::$data[$key] = $value;
    }

    public static function get(string $key): mixed {
        return self::$data[$key] ?? null;
    }
}

// 正确方向:请求级对象在处理函数内创建,不写入跨请求静态存储
function handle(array $input): array {
    $requestState = ['userId' => $input['userId'] ?? null];
    return ['echo' => $requestState['userId']];
}

常见误区

  • 只清理全局变量,忽略静态属性与单例内部状态:后者是更常见的残留源。
  • 复用数据库连接却不回滚未提交事务:下一请求在残留事务上继续操作。

追问

  • 容器里的单例能保存请求数据吗?答:不能;单例保存无状态服务或可复用资源,请求级数据应注入为方法参数或请求对象。
  • 框架提供的请求上下文如何防残留?答:框架在请求边界重置上下文对象;升级框架版本时核对其常驻模式状态管理策略。

04.5.2.14-005 防止状态残留的代码规范有哪些?

一句话结论

规范要点:避免请求级静态缓存、单例只持有无状态服务、请求数据走方法参数或请求对象、连接在请求后归还干净状态、请求结束显式重置上下文;新代码评审按这几条检查。

概念解释

常驻兼容的设计核心是分清生命周期:进程级(可复用服务、连接)与请求级(用户身份、输入、临时结果)。请求级状态不进入进程级存储;复用资源在每次使用后回到初始状态。规范还应约束后台任务与定时器对共享状态的写入。

原理流程

  1. 标注每个对象/变量的生命周期:进程级还是请求级。
  2. 请求级状态在请求作用域内创建与销毁。
  3. 请求结束执行重置清单:上下文、临时缓存、连接状态。

代码或图示

class RequestContext {
    public function __construct(public readonly int $userId, public readonly string $traceId) {}
}

class OrderService {
    public function __construct(private readonly PriceCalculator $calculator) {}

    public function create(RequestContext $ctx, array $payload): array {
        // 请求数据通过参数传入,不写入服务对象属性
        $price = $this->calculator->estimate($payload);
        return ['user' => $ctx->userId, 'price' => $price];
    }
}

class PriceCalculator {
    public function estimate(array $payload): int {
        return (int) ($payload['amount'] ?? 0);
    }
}

常见误区

  • 在服务对象上缓存上次请求结果作为“优化”:常驻下变成残留。
  • 依赖析构函数清理状态:worker 不退出,析构不会在请求边界执行。

追问

  • 全局配置可以跨请求保留吗?答:只读配置可以;运行期可变配置必须按请求加载或显式刷新。
  • 单元测试如何覆盖残留问题?答:同一 worker 模拟连续两个请求,断言第二请求不读取第一请求的数据。

04.5.2.14-006 FrankenPHP 是什么?能力边界如何?

一句话结论

FrankenPHP 是把 PHP 嵌入 Go 运行时的常驻应用服务器,提供 worker 模式、内置 HTTP 服务与部署打包能力;本机未安装 FrankenPHP,具体特性清单、版本支持与配置方式需以官方文档为准(待确认),本页只归纳公开定位与常见能力方向。

概念解释

FrankenPHP 的定位是现代化 PHP 部署形态:Go 侧承担网络服务与进程管理,PHP 代码在 worker 中常驻执行。常见能力方向包括 worker 模式运行、静态文件服务、HTTP/HTTPS 与进程管理;是否支持特定框架、脚本类型与高级特性,必须查官方兼容矩阵。

原理流程

  1. 核对官方文档确认 FrankenPHP 版本与 PHP 版本支持关系。
  2. 按文档准备 worker 入口与应用适配。
  3. 本机或测试环境安装后验证启动、请求处理与配置项(本机当前不具备该条件)。

代码或图示

// worker 入口骨架(具体引导方式以 FrankenPHP 官方文档为准,待确认)
// 文档中通常区分普通 CGI 请求模式与 worker 常驻模式
function bootstrapApplication(): Container {
    return buildContainer();
}

$container = bootstrapApplication();

// worker 模式下应用在进程内常驻;请求处理由运行时回调进入
function handleRequest(Container $container, array $input): array {
    return ['ok' => true, 'input' => $input];
}

echo 'frankenphp support: not-installed-in-this-env', PHP_EOL;

常见误区

  • 把宣传特性当成已验证能力:未在本机安装前,所有配置参数与协议细节标注待确认。
  • 假设所有框架开箱即用:框架需要具备常驻兼容适配,需查框架兼容说明。

追问

  • FrankenPHP 与 FPM 能否并存部署?答:按运行时形态选择;同一服务通常只暴露一种 HTTP 入口,具体部署方式以官方文档为准(待确认)。
  • 如何在本机验证 FrankenPHP 能力?答:安装对应运行时二进制后,用最小 PHP 应用启动 worker,发请求观察响应、进程行为与日志;记录验证版本与结果。

04.5.2.14-007 FrankenPHP 典型能力方向有哪些?

一句话结论

按公开定位,FrankenPHP 围绕“常驻执行 + 内置服务 + 部署打包”提供能力;具体如 worker 模式、静态资源服务、TLS/HTTP 处理、可执行产物等条目以官方文档当前版本为准,本页不写死未核实的参数名。

概念解释

理解能力分层:运行时层(worker 生命周期、进程管理)、服务层(HTTP 协议、静态文件)、部署层(打包、配置)。面试中应能说出它解决什么问题,同时承认细节需对照文档;不把 RoadRunner 或 Swoole 的特性安到 FrankenPHP 上。

原理流程

  1. 区分运行时、服务、部署三层能力。
  2. 对照官方文档确认每层当前版本提供的功能。
  3. 结合项目框架与运维形态评估适配度。

代码或图示

// 能力分层核对清单(条目是否支持以官方文档为准)
$capabilityLayers = [
    'runtime' => ['worker-lifecycle', 'process-supervision', 'state-reset'],
    'server' => ['http-handling', 'static-files', 'tls-termination'],
    'deployment' => ['artifact-packaging', 'configuration', 'observability-hooks'],
];

foreach ($capabilityLayers as $layer => $items) {
    echo $layer, ': ', implode(', ', $items), PHP_EOL;
}

常见误区

  • 混淆不同常驻运行时的特性:各运行时协议与管理方式不同,不能互相套用配置。
  • 把路线图特性当作已发布能力:区分文档中已发布版本与规划项。

追问

  • 内置静态文件服务适合什么场景?答:小规模应用或单体部署可由运行时直接服务静态资源;高并发静态资源通常仍由 CDN 或专用 Web 服务器承担,具体方案按压测决定。
  • 框架集成层谁提供?答:框架官方适配包或运行时兼容层;接入前核对框架版本要求。

04.5.2.14-008 RoadRunner 是什么?

一句话结论

RoadRunner 是 Go 编写的 PHP 进程管理器与应用服务器,PHP worker 通过进程间协议与管理器通信,由管理器分发任务、回收与重启 worker;本机未安装 RoadRunner,协议细节与配置以官方文档为准(待确认)。

概念解释

RoadRunner 的结构是:Go 侧服务端接收外部请求并管理 PHP worker 池,PHP 侧 worker 按约定协议读取任务、返回结果。与内嵌式运行时不同,它强调独立的进程编排与插件体系。业务 PHP 代码只关注请求处理与状态重置,协议由 worker 库封装。

原理流程

  1. 管理器启动并拉起 PHP worker 进程。
  2. 外部请求到达后,管理器把任务通过协议发给空闲 worker。
  3. worker 处理并回传结果;worker 达到条件后被回收重启。

代码或图示

// PHP worker 侧骨架:协议帧由 RoadRunner 官方 worker 库封装(待确认具体 API)
function workerLoop(callable $handler): void {
    while (receiveTask($task)) {
        try {
            $result = $handler($task);
            sendResponse($result);
        } catch (Throwable $e) {
            error_log('worker error: ' . $e->getMessage());
            sendError($e->getMessage());
        } finally {
            resetRequestState();
        }
    }
}

function receiveTask(mixed &$task): bool {
    // 实际由运行时提供的协议读取实现封装
    return false;
}

function sendResponse(mixed $result): void {}
function sendError(string $message): void {}

常见误区

  • 以为 RoadRunner 是 PHP 扩展:它主要是外部管理器进程加 PHP 侧协议库,形态与 C 扩展不同。
  • 把 worker 内的循环写成一次性脚本:常驻 worker 需要持续接收任务,直到管理器通知退出。

追问

  • RoadRunner 支持哪些语言 worker?答:其插件/ worker 体系可承载多种运行时;PHP 接入方式以官方 PHP worker 文档为准(待确认)。
  • 本机如何验证?答:安装 RoadRunner 与对应 PHP worker 库,跑最小 worker 应用,观察任务分发与进程回收。

04.5.2.14-009 RoadRunner worker 协议与任务收发如何工作?

一句话结论

管理器与 worker 之间通过约定的帧协议交换任务与响应:管理器写入任务数据,worker 读取并处理,再把结果帧回传;具体帧格式、编解码方式与控制消息以 RoadRunner 官方协议文档为准(待确认)。

概念解释

协议层处理序列化、请求/响应配对、错误通知与退出信号。业务代码通常不直接拼帧,而是使用官方 worker 库提供的回调接口。理解协议边界有助于排查:worker 无响应、结果错乱、进程不退出等问题多在协议适配层。

原理流程

  1. 管理器按协议帧结构写入任务负载与元数据。
  2. worker 解码任务,执行业务回调。
  3. worker 编码结果帧回传;错误与退出信号走对应控制帧。

代码或图示

// 协议帧概念示意(字段名为通用描述,非 RoadRunner 真实帧格式,待确认)
$frame = [
    'type' => 'task',
    'payload' => ['controller' => 'order', 'action' => 'show', 'id' => 1],
];

function decodeTask(array $frame): array {
    return $frame['payload'] ?? [];
}

function encodeResponse(mixed $data): array {
    return ['type' => 'response', 'payload' => $data];
}

$task = decodeTask($frame);
echo json_encode(encodeResponse(['task' => $task['action']])), PHP_EOL;

常见误区

  • 自行猜测二进制帧格式:协议细节未核实前不要在文档中写死字节布局。
  • 业务层直接操作协议流:应通过官方库接口,避免版本升级后协议变更破坏代码。

追问

  • 任务负载序列化用什么格式?答:以官方 worker 库实现为准;常见为结构化编解码,具体格式待确认。
  • 协议层超时谁控制?答:管理器与 worker 两侧都可能有超时配置;具体参数见官方配置文档(待确认)。

04.5.2.14-010 RoadRunner worker 重载与回收机制如何工作?

一句话结论

worker 可按最大任务数、内存阈值、空闲超时或手动信号被管理器回收并重新拉起;平滑重载要求旧 worker 处理完在途任务后退出,新 worker 接替。具体配置项名称与默认值以官方文档为准(待确认)。

概念解释

回收机制是常驻稳定性的关键:防止内存缓慢增长、状态累积与泄漏扩散。任务数上限让 worker 定期“重生”;内存阈值作为兜底;手动重载用于部署与配置更新。回收策略需要在重启成本与泄漏风险之间权衡。

原理流程

  1. 管理器监控 worker 的任务数、内存与空闲状态。
  2. 达到阈值时标记 worker 待退出,等待在途任务完成。
  3. 拉起新 worker 接替,旧 worker 退出结束生命周期。

代码或图示

// 回收判定骨架(阈值与配置项以官方文档为准,待确认)
function shouldRecycle(int $jobsProcessed, int $memoryBytes, int $maxJobs, int $memoryLimit): bool {
    return $jobsProcessed >= $maxJobs || $memoryBytes >= $memoryLimit;
}

$recycle = shouldRecycle(jobsProcessed: 1000, memoryBytes: 48 * 1024 * 1024, maxJobs: 1000, memoryLimit: 64 * 1024 * 1024);
echo 'recycle: ', var_export($recycle, true), PHP_EOL;

// 平滑重载步骤:摘流 -> 完成在途任务 -> 旧 worker 退出 -> 新 worker 就绪
$gracefulSteps = ['drain-traffic', 'finish-inflight', 'exit-old', 'spawn-new'];
echo implode(' -> ', $gracefulSteps), PHP_EOL;

常见误区

  • worker 只按任务数回收,忽略内存增长:存在泄漏时任务数未到但内存已升高。
  • 强制杀死在途 worker:请求被中断;平滑退出必须等待当前任务完成。

追问

  • 配置上限如何确定?答:先压测观察单 worker 内存随任务数的增长曲线,取安全阈值;具体默认值查官方文档。
  • 重载期间请求会失败吗?答:摘流后旧 worker 只处理存量任务,新 worker 就绪后承接新流量;编排不当则可能出现短暂无可用 worker。

04.5.2.14-011 常驻模式下 OPcache/JIT 行为有什么差异?

一句话结论

常驻进程中编译结果与已加载类在内存中保留更久,单次编译成本被摊薄;JIT 生成的机器码在长生命周期进程中复用价值更高,但仍受反射、动态调用与内存预算约束。细节原理见 04.5.2.8,本页只对比部署形态差异。

概念解释

FPM 进程频繁重建,OPcache 共享缓存跨进程生效;常驻 worker 进程内保留类与编译产物。JIT 在常驻模型下避免了每进程重复编译机器码的问题,但 JIT 适用边界(热点计算、动态特性多的代码)不因常驻而改变。CLI 环境下 OPcache 默认可能关闭,本机 CLI 探针 opcache_get_status() 返回 false。

原理流程

  1. 启动期类加载与编译结果进入进程内存。
  2. 请求期复用 opcode 与已编译机器码。
  3. 代码更新时通过缓存失效或 worker 重启刷新产物。

代码或图示

// 本机 CLI OPcache 状态探针
$status = function_exists('opcache_get_status') ? opcache_get_status(false) : false;
echo 'cli opcache status: ', $status === false ? 'disabled-or-unavailable' : 'active', PHP_EOL;

// 常驻场景关注的缓存指标
$cacheMetrics = ['hit-rate', 'cached-scripts', 'memory-used', 'invalidation-count'];
echo implode(', ', $cacheMetrics), PHP_EOL;

常见误区

  • 以为常驻模式下 OPcache 配置可以忽略:共享内存、时间戳校验与预加载策略仍需按部署形态调整。
  • 开 JIT 就一定提速:JIT 收益取决于代码热点类型,常驻不改变适用边界。

追问

  • 常驻模式代码更新如何刷新缓存?答:按运行时机制重启/重载 worker,或依赖 OPcache 时间戳校验;生产常用显式重载配合发布流程。
  • JIT 机器码占用常驻内存吗?答:占用 JIT 缓冲区;常驻长生命周期下需关注缓冲区预算与回收,见 04.5.2.8。

04.5.2.14-012 常驻模式下异常与致命错误如何影响 worker 存活?

一句话结论

可捕获异常应在请求边界内处理,不允许穿过 worker 循环;致命错误或未捕获异常可能导致 worker 退出,由管理器重新拉起。worker 异常处理的目标是隔离单次失败,避免污染进程或拖垮整个池。

概念解释

与 FPM 不同,常驻 worker 退出意味着进程重建成本;但带故障残留的 worker 继续服务会扩大问题。策略是:业务异常在请求层兜底记录;不可恢复错误主动退出让管理器重建;worker 退出前不留下脏状态。

原理流程

  1. 请求处理包裹在 try/catch/finally 中。
  2. 业务异常记录后返回错误响应,worker 继续存活。
  3. 不可恢复错误标记 worker 待退出,清理后终止,管理器拉起新进程。

代码或图示

function handleWorkerTask(callable $handler, mixed $task): bool {
    try {
        $handler($task);
        return true;
    } catch (BusinessException $e) {
        error_log('business: ' . $e->getMessage());
        return true;
    } catch (Throwable $e) {
        error_log('fatal, worker should restart: ' . $e->getMessage());
        return false;
    } finally {
        resetRequestState();
    }
}

class BusinessException extends RuntimeException {}

$alive = handleWorkerTask(function () { echo 'ok'; }, []);
echo 'worker alive: ', var_export($alive, true), PHP_EOL;

常见误区

  • 兜底 catch 后不清理状态就继续接新请求:残留问题被带入后续任务。
  • 所有异常都让 worker 退出:业务可恢复异常反复重建进程,吞吐下降。

追问

  • 未捕获异常会走到全局异常处理器吗?答:worker 循环内的兜底先捕获;漏出循环的异常按运行时与管理器策略处理,具体行为待确认。
  • 如何区分可恢复与不可恢复错误?答:按异常类型、资源是否损坏、状态是否可清理判断;无状态校验失败可恢复,连接/内存损坏需重建 worker。

04.5.2.14-013 常驻进程中的连接资源生命周期如何管理?

一句话结论

数据库、Redis、HTTP 客户端等连接在进程内复用,但必须管理失效重建、事务归还与并发使用;请求结束时连接要回到干净状态,避免跨请求残留事务或会话。

概念解释

连接复用是常驻性能收益的重要来源,也带来新问题:连接长时间空闲被服务端断开、连接上残留未提交事务、多个请求共享同一连接造成交错使用。管理要点:使用前校验可用性,失效后重建,请求后提交/回滚并归还。

原理流程

  1. 启动期或首次使用时建立连接。
  2. 请求内通过连接执行操作,结束时提交或回滚。
  3. 检测到连接失效时重建;空闲超时与最大生命周期按服务端限制配置。

代码或图示

class ConnectionPool {
    private ?object $connection = null;

    public function get(): object {
        if ($this->connection === null || !$this->isAlive($this->connection)) {
            $this->connection = $this->connect();
        }
        return $this->connection;
    }

    public function resetAfterRequest(): void {
        // 请求结束:回滚未提交事务,归还干净连接
    }

    private function connect(): object {
        return new stdClass();
    }

    private function isAlive(object $conn): bool {
        return true;
    }
}

$pool = new ConnectionPool();
$conn = $pool->get();
$pool->resetAfterRequest();
echo 'connection managed', PHP_EOL;

常见误区

  • 单连接被并发请求共享:worker 内通常串行处理请求,但复用设计仍需考虑连接使用边界。
  • 只建不验:长空闲连接被对端关闭后,下一请求首次操作才报错。

追问

  • 连接池大小如何配置?答:按 worker 数量、每请求连接使用方式与数据库最大连接数推算;压测观察等待与超时。
  • HTTP 客户端复用要注意什么?答:连接池保留 keep-alive 连接,需清理默认请求头与认证信息,避免跨请求携带。

04.5.2.14-014 常驻与 FPM 的性能与运维如何对比?

一句话结论

性能对比必须以同口径压测为准:常驻通常降低单请求启动开销、提升吞吐,但增加内存占用与状态管理复杂度;运维上常驻需要管理 worker 池、回收策略与重载流程,FPM 模型成熟、隔离简单。

概念解释

对比维度包括:吞吐(每秒请求数)、延迟(平均与分位)、内存占用、冷启动耗时、部署与排障复杂度。常驻的收益在重初始化应用上更明显;简单接口或启动成本很低的场景,差异可能有限。运维成本不能忽略:状态残留排查、worker 回收、连接管理都是常驻新增职责。

原理流程

  1. 准备相同代码与压测脚本,分别在 FPM 与常驻环境运行。
  2. 采集吞吐、延迟分位、内存、CPU 与错误率。
  3. 结合运维投入评估选型,不以单点指标下结论。

代码或图示

// 压测对比指标骨架
$metrics = [
    'throughput' => 'requests per second',
    'latency-p50' => 'median response time',
    'latency-p95' => 'tail response time',
    'memory-per-worker' => 'resident memory',
    'cold-start' => 'time to first request after boot',
    'error-rate' => 'failed requests ratio',
];

foreach ($metrics as $key => $desc) {
    echo $key, ': ', $desc, PHP_EOL;
}

// 运维对比维度
$opsAspects = ['worker-pool', 'recycle-policy', 'state-reset', 'connection-lifecycle', 'rollback'];
echo implode(', ', $opsAspects), PHP_EOL;

常见误区

  • 引用他人压测数据作为自己项目结论:应用形态、框架与代码路径不同,必须自测。
  • 只看吞吐不看延迟尾部:常驻可能在复用问题上出现长尾延迟。

追问

  • 常驻内存一定更高吗?答:单进程内存通常高于单次 FPM 请求,但省去重复初始化;总量对比按压测进程数与占用计算。
  • 哪种模型排障更简单?答:FPM 请求隔离、上下文随进程销毁;常驻问题可能跨请求残留,需要更完善的观测与复现手段。

04.5.2.14-015 框架兼容性是常驻迁移的前提吗?

一句话结论

是。框架需要在请求边界重置上下文、管理服务生命周期并提供常驻适配;未做常驻兼容的框架代码容易出现状态残留。迁移前应核对框架官方对目标运行时的支持说明。

概念解释

框架负责容器、请求对象、中间件管道、错误处理等基础设施。如果框架假设“请求结束即销毁一切”,迁移常驻后单例、上下文、请求数据都可能残留。核对内容:框架是否提供 worker 引导、请求重置钩子、服务注册方式与已知兼容问题。

原理流程

  1. 查框架文档的常驻运行时支持章节。
  2. 核对框架版本与运行时版本兼容矩阵。
  3. 在测试环境跑连续请求用例,验证上下文不串扰。

代码或图示

// 框架常驻适配核对清单
$frameworkChecks = [
    'bootstrap-once' => '启动期初始化只执行一次',
    'request-reset' => '请求边界重置上下文与临时状态',
    'service-lifecycle' => '单例服务不保存请求数据',
    'middleware-reset' => '中间件管道无跨请求残留',
];

foreach ($frameworkChecks as $check => $note) {
    echo $check, ': ', $note, PHP_EOL;
}

常见误区

  • 直接把 FPM 应用丢进常驻 worker:框架未适配时残留问题随机出现,难以复现。
  • 只看框架宣传支持,不跑连续请求测试:串扰问题需要多请求连续压测暴露。

追问

  • 自研框架如何补常驻兼容?答:实现启动引导、请求上下文作用域、请求后重置钩子;参考主流框架的 worker 生命周期设计。
  • 老框架无法适配怎么办?答:维持 FPM 部署,或评估框架升级/替换;不强行常驻。

04.5.2.14-016 从 FPM 迁移到常驻运行时有哪些步骤?

一句话结论

迁移步骤:核对框架与运行时兼容 → 梳理进程级/请求级状态 → 改造残留点与连接管理 → 测试环境连续请求与压测 → 灰度上线并观测回收与内存。

概念解释

迁移不是换启动命令,而是按常驻模型重构状态边界。先在测试环境暴露残留与泄漏,再小流量灰度;每一步保留回退到 FPM 的部署能力,直到常驻指标稳定。

原理流程

  1. 兼容评估:框架、依赖、扩展对目标运行时的支持。
  2. 代码改造:状态生命周期划分、连接重置、worker 异常处理。
  3. 验证:连续请求串扰测试、压测对比、内存与回收观察。
  4. 灰度:小流量上线,观测错误率、延迟、内存后扩大。

代码或图示

// 迁移检查清单骨架
$migrationSteps = [
    'compat-review' => '框架/依赖/扩展兼容核对',
    'state-audit' => '静态、全局、单例、连接残留排查',
    'connection-reset' => '连接事务与会话归还',
    'worker-hardening' => '异常兜底与退出策略',
    'staging-test' => '连续请求与压测',
    'canary' => '灰度观测与回退准备',
];

foreach ($migrationSteps as $step => $note) {
    echo $step, ': ', $note, PHP_EOL;
}

常见误区

  • 跳过代码改造直接部署:残留问题在生产随机出现,复现困难。
  • 灰度期不准备 FPM 回退:常驻异常时无法快速切回稳定形态。

追问

  • 迁移周期多长?答:取决于代码中残留点数量与框架成熟度;先做测试环境验证,不在生产仓促切换。
  • 迁移后还能切回 FPM 吗?答:代码应保持两种模型兼容;部署配置与运行时入口可切换,具体由项目部署结构决定。

04.5.2.14-017 常驻迁移中的常见坑有哪些?

一句话结论

常见坑包括:静态/单例残留请求数据、复用连接带事务或认证信息、超时语言环境残留、定时器/后台任务共享状态、文件句柄未释放、异常漏出 worker 循环。

概念解释

这些问题在 FPM 下被进程销毁掩盖,常驻后逐一暴露。典型表现:A 用户看到 B 用户数据、旧语言包、连接事务错乱、后台任务污染请求上下文。排查方法是连续构造两个不同身份请求,检查第二请求是否携带第一请求痕迹。

原理流程

  1. 枚举共享状态载体:静态、全局、单例、连接、客户端、句柄。
  2. 逐类检查请求期写入与请求后重置。
  3. 用连续请求测试复现并修复残留。

代码或图示

// 残留排查探针骨架:模拟连续请求后检查上下文
function runTwoRequests(callable $factory): array {
    $ctx1 = $factory();
    $ctx1->setUser(1001);
    $snapshot1 = $ctx1->snapshot();

    $ctx2 = $factory();
    $snapshot2 = $ctx2->snapshot();

    return ['first' => $snapshot1, 'second' => $snapshot2];
}

class RequestContext {
    private ?int $userId = null;
    public function setUser(int $id): void { $this->userId = $id; }
    public function snapshot(): ?int { return $this->userId; }
}

$result = runTwoRequests(fn() => new RequestContext());
echo json_encode($result), PHP_EOL;

常见误区

  • 只测单请求功能正确:串扰问题必须多请求连续触发。
  • 忽略时区、语言、locale 等运行期全局设置:它们也是进程级残留状态。

追问

  • 后台任务/定时器与请求 worker 如何隔离?答:避免在请求 worker 中持有长生命周期任务;后台任务走独立进程或调度机制,共享数据通过外部存储交换。
  • 文件句柄残留怎么发现?答:监控进程打开文件数与内存;请求内打开的句柄在作用域结束释放,不复用全局句柄。

04.5.2.14-018 常驻进程中的时区、语言环境等全局状态如何处理?

一句话结论

时区、locale、错误处理器、默认编码等进程级全局设置应在启动期统一设定;请求内不要修改全局状态,需要按请求切换时在请求结束恢复,避免残留到下一请求。

概念解释

PHP 部分配置是进程全局的:时区、字符集、错误处理器、内部编码等。FPM 每请求重置,常驻中请求内调用 date_default_timezone_set、setlocale 会影响后续 worker 上的所有请求。正确做法是启动期设定统一值,请求级差异通过显式参数传递。

原理流程

  1. 启动期读取配置,设定全局时区、locale 与编码。
  2. 请求内不写全局设置;本地化需求通过参数或局部格式化处理。
  3. 确需临时切换的,在 finally 中恢复原值。

代码或图示

// 启动期统一设定(示意,实际值来自配置)
date_default_timezone_set('Asia/Shanghai');

function formatPrice(float $amount, string $locale): string {
    // 本地化格式通过局部处理,不修改进程全局 locale
    return number_format($amount, 2);
}

function handleRequest(array $input): string {
    $price = (float) ($input['amount'] ?? 0);
    return formatPrice($price, $input['locale'] ?? 'default');
}

echo handleRequest(['amount' => 19.9, 'locale' => 'zh']), PHP_EOL;

常见误区

  • 在控制器里设置时区/locale:修改的是整个 worker 的全局状态。
  • 临时切换后不恢复:下一请求继承错误的语言环境。

追问

  • 全局错误处理器在常驻中如何设置?答:启动期注册一次;请求级错误处理通过框架中间件或异常边界,不在请求内反复注册/恢复。
  • 编码设置影响哪些函数?答:字符串与多字节函数的默认编码;启动期统一后请求内不显式修改。

04.5.2.14-019 FPM、FrankenPHP、RoadRunner 如何选型?

一句话结论

选型按团队运维成熟度、框架兼容性、性能收益与迁移成本综合判断:FPM 适合成熟稳定、隔离要求高的场景;常驻运行时适合启动成本高、吞吐敏感且能做好状态管理的项目;具体运行时之间的能力差异以官方文档与压测为准。

概念解释

没有 universally 最优解:常驻收益依赖应用初始化成本与框架适配度;常驻引入的状态管理与运维复杂度需要团队承担。选型步骤:先量化 FPM 下的启动开销与瓶颈,再评估框架兼容与改造量,最后小范围验证常驻收益。

原理流程

  1. 定位当前瓶颈:是启动开销、吞吐受限还是连接复用不足。
  2. 评估框架兼容与代码改造量。
  3. 测试环境对比压测与运维成本,决定部署形态。

代码或图示

// 选型决策维度骨架
$selection = [
    'fpm' => ['成熟隔离', '部署简单', '每请求初始化成本'],
    'frankenphp' => ['嵌入式常驻', '部署打包', '框架兼容待核对'],
    'roadrunner' => ['外部进程编排', 'worker 池管理', '协议适配待核对'],
];

foreach ($selection as $runtime => $traits) {
    echo $runtime, ': ', implode(', ', $traits), PHP_EOL;
}

// 选型前置条件:框架兼容、状态可审计、观测就绪、可回退
$prerequisites = ['framework-compat', 'state-auditable', 'observability', 'rollback-ready'];
echo implode(', ', $prerequisites), PHP_EOL;

常见误区

  • 因“常驻更先进”直接切换:性能收益未量化、改造量未评估。
  • 忽略团队排障能力:常驻问题需要跨请求观测与复现手段支撑。

追问

  • 同一项目能混合部署吗?答:按服务拆分选型,部分服务 FPM、部分常驻是可选项;共享数据格式与协议需保持兼容。
  • 选型结论需要书面记录吗?答:应记录压测数据、兼容核对结果与回退方案,作为后续扩容与迁移依据。

04.5.2.14-020 本机环境限制与待确认项有哪些?

一句话结论

本机为 PHP 8.5.9 CLI NTS,未安装 swoole/swow、FrankenPHP、RoadRunner;本页运行时协议、配置参数、默认值与框架兼容矩阵均属待确认项,验证手段是安装对应运行时后用最小 worker 应用实测并记录版本。

概念解释

语言层事实(PHP 版本、已加载扩展、反射与错误处理 API)可由本机探针验证;常驻运行时生态行为依赖外部程序与框架适配,不在本机验证范围内。文档中所有未实测的运行时细节均标注待确认,不写死参数名与默认行为。

原理流程

  1. 本机探针确认语言层与已加载扩展。
  2. 列出运行时相关待确认清单:协议、回收策略、配置项、兼容框架。
  3. 在测试环境安装对应运行时,逐项实测回填结论。

代码或图示

// 本机环境探针
echo 'PHP ', PHP_VERSION, ' (', PHP_SAPI, ')', PHP_EOL;
echo 'opcache: ', extension_loaded('Zend OPcache') ? 'loaded' : 'missing', PHP_EOL;

$runtimeChecks = ['swoole', 'swow', 'frankenphp', 'roadrunner'];
foreach ($runtimeChecks as $ext) {
    echo $ext, ': ', extension_loaded($ext) ? 'loaded' : 'not-loaded', PHP_EOL;
}

// 待确认清单与验证手段
$pending = [
    'worker-protocol' => '安装运行时后读官方协议文档并跑最小 worker',
    'recycle-config' => '实测任务数/内存/空闲回收参数与默认值',
    'framework-compat' => '核对框架兼容矩阵并连续请求测试',
    'deployment-args' => '实测启动命令、配置文件与重载流程',
];
foreach ($pending as $item => $method) {
    echo $item, ' <- ', $method, PHP_EOL;
}

常见误区

  • 把其他运行时的经验参数套到本页结论:未实测前不提供具体数值承诺。
  • 忽略 CLI 与服务端 SAPI 差异:本机 CLI 探针结果不代表生产常驻环境配置。

追问

  • 后续在测试环境验证后需要更新本页哪些内容?答:协议描述、回收配置、框架兼容结论与压测对比数据;替换对应待确认标注。
  • 本页与 04.5.2.7、04.5.2.8 如何分工?答:Fiber 协程模型见 04.5.2.7,OPcache/JIT 编译层级见 04.5.2.8;本页聚焦常驻进程模型、运行时选型与迁移运维。