经典模式

经典模式会在每个到达的请求上，从头执行一个普通的 PHP 前端控制器——就是你早就交给 php-fpm 的那个 public/index.php。Rapira 顶替掉 php-fpm，应用不需要做任何改动：超全局变量照样填好，脚本从上到下执行，打印出来的东西就是响应。

每个请求都是全新的状态

每个请求都会完整走一遍 PHP 的请求周期：请求启动、执行入口脚本、请求关闭。脚本一路建起来的东西——全局变量、静态属性、DI 容器、ORM 的 identity map——都会在下一个请求开始之前拆干净，和在 php-fpm 下一模一样。

忘了关的句柄、只初始化了一半的单例、把请求数据顺手塞进静态属性的库——这些都不会影响到下一个请求，因为脚本创建的一切都活不过创建它的那个请求。例外和 php-fpm 完全一样：持久连接和扩展级的状态住在 worker 进程里，不属于某一个请求。那些当初没有考虑过长驻进程的代码，在这里不用改动就能跑。fastcgi_finish_request() 来自 php-fpm 这个可执行文件，在 Rapira 下无法使用；Rapira 提供的是契约完全相同的 rapira_finish_request()——提前把响应刷给客户端，之后接着干活——具体说明见 HTTP 页。

每个请求都要把应用重新启动一遍：自动加载器、配置、容器、路由。更多信息见执行模式。

怎么开启

选定这个模式有两种写法，效果完全一样：

命令行上加 --classic，紧挨着入口脚本。
在 rapira.toml 的 [pool] 段里写 classic = true。

这个参数只能把模式打开——没有 --no-classic，所以配置文件里只要写了 classic = true，命令行怎么写都还是经典模式。其余部分依旧遵循通常的优先级：命令行参数压过配置文件。完整的键列表见配置。

经典模式的入口脚本就是普通 PHP：

php

<?php
// index.php
header('Content-Type: text/plain');
echo "Hello, " . ($_GET['name'] ?? 'anonymous') . "!\n";
echo "Method: {$_SERVER['REQUEST_METHOD']}\n";

两种方式都能让 Rapira 指向它：

CLIrapira.toml

bash

rapira serve --classic public/index.php

toml

[pool]
entrypoint = "public/index.php"
classic = true

用配置文件时，启动命令是 rapira serve --config rapira.toml。pool.entrypoint 写成相对路径时，是相对配置文件所在的目录解析的，所以这份配置搬到哪儿都能用；而命令行上的相对脚本路径，则是相对当前目录解析。其余参数见命令行参考。

入口脚本

Rapira 不会把 URL 映射到磁盘上的文件，自己也不从磁盘提供任何内容。不管请求的路径是什么，跑的都是你指定的那个入口脚本，URL 则通过 $_SERVER['REQUEST_URI'] 交给应用自己去路由。

CGI 变量也就顺理成章：SCRIPT_FILENAME 永远是入口脚本，SCRIPT_NAME 是它带前导斜杠的文件名（/index.php），DOCUMENT_ROOT 是它所在的目录。静态资源需要由 Rapira 前面的组件来提供——一个 CDN，或者部署那一页搭起来的反向代理。

OPcache

从头执行重置的是应用的状态，不是编译好的字节码。主进程只在模块启动时启动一次 PHP，而且是在 fork 出任何 worker 之前——所以 OPcache 只创建一次共享内存段，之后 fork 出来的每个 worker 都继承同一份映射。只要开了 OPcache，编译后的脚本就会跨请求、跨整个进程池一直缓存着，重新执行前端控制器并不意味着重新解析它。

进程池本身在两种模式下是一样的：master fork 出一批 worker，每个 worker 一次处理一个请求，并发能力就来自进程数量。关于 master 进程和它的 worker，更多信息见进程模型那一页。

在经典模式下调用 Rapira\create_plugin_handler() 会抛出 Rapira\RapiraException：plugin handlers require worker mode。脚本随请求一起结束，根本没有常驻循环可以接过这个 handler。Worker 脚本属于 SAPI Worker 模式。

在 Classic 和 SAPI Worker 之间做选择

如果应用的状态撑不过第二个请求——老代码库、往静态属性里泄漏的框架、你管不着的第三方库——就用经典模式；正从 php-fpm 迁移过来、想一次只改一件事的时候，也用它。如果代码扛得住一个不退出的进程，而且你想去掉每个请求的启动开销，就用 SAPI Worker 模式。执行模式那一页描述了全部四种模式，其中今天已经发布的是 Classic 和 SAPI Worker。

经典模式 ​

每个请求都是全新的状态 ​

怎么开启 ​

入口脚本 ​

OPcache ​