laravel 11+ 应选 octane，laravel 9 及更早版本用 laravel-swoole（laravel-s）更稳妥；二者架构不同，octane 是官方抽象层，支持 swoole/roadrunner/frankenphp，laravel-swoole 已归档且不兼容 laravel 10+。
别直接选 Laravel-S 或 Octane，先看你的 Laravel 版本和部署目标：Laravel 11+ 强烈倾向 Octane；Laravel 9 及更早版本用 laravel-swoole（即 Laravel-S）更稳妥；Octane 不是 laravel-swoole 的升级版，二者架构、维护节奏、配置逻辑完全不同。
laravel-swoole（Laravel-S）只适配旧版 Laravel，且已停止主动维护
laravel-swoole 是社区早期为 Laravel 5.x–9.x 封装的 Swoole 接入层，它不改内核，只接管 HttpKernel::handle() 生命周期。2024 年底起，其 GitHub 主仓库已归档，不再接受 PR，也不再适配 Laravel 10+ 的容器绑定变更（比如 Request 实例在协程中复用导致的 UploadedFile 内存泄漏）。如果你用的是 Laravel 10 或更新版本，强行安装 laravel-swoole 会遇到 Target class [App\Http\Kernel] does not exist 或中间件重复执行等隐性问题。
常见错误现象：
- 启动后首次请求正常，后续请求
Request::hasFile()始终返回false—— 因为上传临时文件句柄被协程复用，未重置 - 队列任务在
task_worker中执行时，Log::info()输出乱序或丢失 —— laravel-swoole 的日志通道未做协程安全封装 - 配置了
task_worker_num > 0，但dispatch(new SendEmail)仍走 sync 驱动 —— 没切到redis或database队列驱动，或没在config/queue.php中显式设置'default' => 'redis'
Octane 是 Laravel 官方抽象层，统一管理 Swoole / RoadRunner / FrankenPHP
Octane 不是“另一个 Swoole 扩展”，而是把服务器能力标准化为接口：它定义了 ServerProvider、TaskExecutor、RequestHandler 等契约，Swoole 只是其中一种实现。这意味着你换服务器（比如从 Swoole 切到 FrankenPHP），只需改 config/octane.php 里的 'server' => 'frankenphp'，其他代码几乎不用动。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
关键实操点：
-
Octane::concurrently()底层调用的是 Swoole 的task进程，不是原生协程 —— 所以不能在concurrently里直接用Co\MySQL::query()，必须走 Laravel 的DB::facade（它内部做了协程连接池代理） -
octane:install生成的config/octane.php中，'max_requests'默认是0（不限制），但生产环境建议设为1000–3000，避免长时间运行导致内存缓慢增长 - 启用 HTTPS 时，Octane 要求 Web 服务器（如 Nginx）**关闭 SSL 终结**，否则
Request::isSecure()永远返回false；正确做法是让 Octane 直接监听443并配置ssl_cert_file和ssl_key_file
配置项映射关系最容易混淆：哪些能配，哪些根本无效
laravel-swoole 的 config/swoole_http.php 和 Octane 的 config/octane.php 看似都是“Swoole 配置”，但可操作范围天差地别：
-
worker_num：两者都支持，但 laravel-swoole 中若设得过高（> CPU×4），容易触发 Laravel 的QueueListener与 Worker 冲突；Octane 中该值由'workers' => auto自动计算，手动设需同步调整'max_execution_time' -
enable_coroutine：laravel-swoole 配置文件里有这一项，但 Octane **根本不暴露这个开关** —— 它默认开启协程，并通过Swoole\Runtime::enableCoroutine()在启动时强制启用，关不掉 -
http_compression、open_http2_protocol：这些 Swoole 底层参数在 laravel-swoole 配置中**完全不可见**，Octane 同样不提供入口；真要用，得自己写octane:start --server=swoole --swoole-options='{"http_compression":true}'，但风险自担 -
log_file路径：两者都要求绝对路径；相对路径（如storage/logs/octane.log）会导致主进程创建文件后，Worker 进程因权限或 chdir 失败而写入静默失败
最常被忽略的一点：Octane 的热重载（--watch）依赖 pcntl 扩展，而 Docker 官方 PHP 镜像默认禁用 pcntl；如果你用 Sail 或自建容器，必须在 Dockerfile 中显式启用：RUN docker-php-ext-enable pcntl，否则 php artisan octane:start --watch 启动就报错退出。
