PHP如何用Spiral框架开发，RoadRunner构建现代应用

本文深入剖析了使用Spiral框架构建现代PHP应用的核心实践与常见陷阱：它彻底摒弃传统PHP开发模式，依赖RoadRunner作为高性能应用服务器，而非php artisan serve；详解了如何正确安装启动、编写PSR-15兼容中间件、精准时机加载.env环境变量，以及直击DBAL查询缓慢的根源——默认开启的内存级SQL日志（非ORM性能问题），并给出按环境配置logging、避免worker内存泄漏等生产级调优方案，帮助开发者跳出Laravel思维定式，真正驾驭Spiral+RoadRunner这一轻量、高速、面向现代部署场景的技术栈。

怎么在 PHP 里启动 Spiral 应用（不是 Laravel 那套）

Spiral 不是传统 PHP 框架，它依赖 RoadRunner 作为应用服务器，php artisan serve 这类命令根本不存在。直接 php app.php 会报错，因为 Spiral 的入口不是普通脚本，而是由 RoadRunner 加载的 SAPI 入口。

正确做法是先确保 RoadRunner 已安装且可执行，再运行：

rr serve

这会读取当前目录下的 .rr.yaml（或 rr.yaml），加载 Spiral 的 app.php 入口。常见错误包括：

• command not found: rr → 没装 RoadRunner，得用 curl -s https://raw.githubusercontent.com/roadrunner-server/roadrunner/main/install.sh | bash 或下载二进制放 $PATH
• Failed to load config → .rr.yaml 缺失或路径不对，Spiral 官方模板里自带，但自己手搭时容易漏
• 改了 app.php 没生效 → RoadRunner 默认启用 worker reuse，要加 rr reset 或关掉 reset_mode: none 调试时才热更

为什么 Spiral 的 HTTP 中间件和 Laravel 完全不兼容

Spiral 使用 PSR-15 标准中间件，但它的生命周期绑定在 RoadRunner 的 request-response 循环里，不是 Laravel 那种基于 Illuminate\Http\Request 的对象链。你塞一个 App\Http\Middleware\CheckAge 进去，会直接抛 TypeError: Argument 1 passed to ... must be instance of Psr\Http\Server\MiddlewareInterface。

实操上必须重写中间件，继承 Spiral\Http\MiddlewareInterface 或实现 Psr\Http\Server\MiddlewareInterface：

class AgeMiddleware implements MiddlewareInterface
{
    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        if ($request->getQueryParams()['age'] ?? 0  'Too young'], 403);
        }
        return $handler->handle($request);
    }
}

注意点：

• 别用 $request->input() —— Spiral 的 ServerRequestInterface 没这个方法，要用 $request->getQueryParams() 或 $request->getParsedBody()
• 中间件注册位置在 app/src/Application/Bootloader/HttpBootloader.php 的 addMiddleware()，不是 app/Http/Kernel.php
• 顺序很重要：Spiral 中间件是“外层包裹”，越先注册的越靠近请求入口，和 Laravel 的“数组索引顺序”语义不同

怎么让 Spiral 正确读取 .env 文件（不是靠 vlucas/phpdotenv 自动加载）

Spiral 默认不自动加载 .env，哪怕你 composer require 了 vlucas/phpdotenv，getenv('DB_HOST') 依然返回 false。原因在于 Spiral 的容器启动早于 dotenv 加载时机，环境变量没进 PHP 的 superglobal。

解决办法是在 app.php 入口最顶部手动加载：

use Dotenv\Dotenv;

if (file_exists(__DIR__.'/.env')) {
    Dotenv::createImmutable(__DIR__)->load();
}

但要注意：

• 必须放在 require __DIR__.'/vendor/autoload.php'; 之后、new \Spiral\Bootstrap\Kernel(...) 之前，否则 Spiral 的 Bootloader 会提前初始化容器，错过变量
• 如果用了 RoadRunner 的 env: true 配置项，.env 会被忽略——RoadRunner 会用自己的 env 注入逻辑覆盖 PHP 的 getenv，此时应把变量写进 .rr.yaml 的 environment 块
• APP_ENV=production 这类值会影响 Spiral 的调试行为（比如是否显示错误详情），漏掉会导致本地开发看不到异常堆栈

为什么 DBAL 查询慢得离谱，而 Laravel 同样 SQL 却很快

Spiral 的 Database\Database 默认开启 query logging 和 debug mode，尤其在 APP_ENV=local 下，每条 SQL 都被包装进 QueryLogger 并记录到内存，不做 GC 就会越积越多。不是 ORM 慢，是日志开太狠。

临时关闭方式（开发调试完务必关）：

// 在 app/src/Application/Bootloader/DatabaseBootloader.php
public function boot(DatabaseProviderInterface $db)
{
    $db->addDatabase('default', [
        'driver' => 'mysql',
        // ...
        'logging' => false, // ← 关键
    ]);
}

更稳妥的做法是按环境区分：

• 生产环境强制 'logging' => false，并禁用 spiral/jobs 的失败队列日志（它也默认开）
• 本地调试想看 SQL？用 spiral/monolog + DatabaseLogger 写文件，别走内存 logger
• 别信文档里 “Spiral is faster than Laravel” 的 benchmark —— 那些测试都关了 logging，你开的状态下对比毫无意义

真正卡住的地方往往是 RoadRunner 的 worker 内存没回收，查一次 DB 就涨几 MB，跑几百次后 OOM 重启，这种问题不会报错，只会让你觉得“接口时快时慢”。

今天关于《PHP如何用Spiral框架开发，RoadRunner构建现代应用》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！