Laravel Octane 是基于 Swoole 或 RoadRunner 的高性能服务器扩展,通过常驻内存提升响应速度与并发能力;需安装扩展包、配置驱动、调整参数并启动服务。

如果您希望提升 Laravel 应用的响应速度与并发处理能力,Laravel Octane 是一个基于 Swoole 或 RoadRunner 的高性能服务器扩展。它通过常驻内存的方式避免传统 PHP-FPM 每次请求重新加载框架的开销。以下是安装并配置 Laravel Octane 的具体步骤:
一、确认环境依赖并安装 Octane 扩展包
Laravel Octane 需要 PHP 8.0+、Composer 2.x 及兼容的扩展(如 Swoole 或 RoadRunner)。安装前需确保已启用对应扩展或安装运行时二进制文件。
1、在已存在的 Laravel 项目根目录下执行 Composer 命令安装 Octane 包。
2、运行:composer require laravel/octane。
3、执行安装脚本:php artisan octane:install,该命令会自动发布配置文件并注册服务提供者。
二、安装并启用 Swoole 扩展
Swoole 是 PHP 的协程、异步、高性能网络通信扩展,Octane 默认优先使用它作为底层驱动。需在 PHP 环境中编译或启用 Swoole 扩展。
1、检查是否已安装:php --ri swoole,若提示“Extension 'swoole' not present”,则需安装。
2、Linux 下使用 PECL 安装:pecl install swoole,安装完成后在 php.ini 中添加 extension=swoole。
3、重启 PHP 服务(如 php-fpm)或验证 CLI 环境:php -m | grep swoole 应返回 swoole。
三、安装 RoadRunner 二进制文件
RoadRunner 是另一种 Octane 支持的高性能应用服务器,无需 PHP 扩展,仅需下载对应平台的可执行文件。
1、运行:php artisan octane:install --server=roadrunner,触发自动下载脚本。
2、若自动下载失败,手动前往 https://github.com/roadrunner-server/roadrunner/releases 下载最新版 rr(Linux/macOS)或 rr.exe(Windows)。
3、将二进制文件放入项目根目录下的 rr 文件夹,并赋予可执行权限(Linux/macOS):chmod +x rr/rr。
四、配置 Octane 启动参数
Octane 配置文件位于 config/octane.php,可调整工作进程数、最大请求数、超时时间等关键参数以适配实际部署场景。
1、打开 config/octane.php,定位到 'server' => 'swoole' 或 'server' => 'roadrunner' 行,确认与所选驱动一致。
2、修改 'workers' => 4 为 CPU 核心数的 1–2 倍(例如 8 核机器设为 12)。
3、根据内存限制调整 'max-requests' => 1000,防止长周期内存泄漏累积。
五、启动 Octane 服务并验证运行状态
启动 Octane 后,Laravel 将脱离传统 Web 服务器(如 Nginx + PHP-FPM),直接监听 HTTP 请求端口,需确保端口未被占用且防火墙放行。
1、执行启动命令:php artisan octane:start。
2、默认监听 http://127.0.0.1:8000,可在命令后添加 --host=0.0.0.0 --port=8080 自定义绑定地址与端口。
3、访问该地址,观察响应头中是否包含 server: swoole 或 server: roadrunner 字样以确认驱动生效。











