Laravel Octane 初体验

Laravel Octane 初体验

Laravel Octane 已经发布好几周了,虽说目前还处于 beta 状态,也挡不住开发者对他的热爱,一个月不到,其在 GitHub 的 star 数量已超过 2K;部分开发者已将他们的项目运行在 Laravel Octane 之上。

如果你还在观望,也可等等一两周后的稳定版。

We will likely go ahead and tag Octane 1.0 as stable next week @Taylor Otwell on Twitter.

为了体验一把加速的魔力,作者已拿一个简单的 H5 项目在生产环境下试了试水,除了一些乱七八糟的问题,其他的都令作者激动不已,客户还表示我们的平台好快啊,下次还找你。

Laravel Octane 的组成

Laravel Octane 内置了两个高性能的应用服务:SwooleRoadRunner,正如官方文档介绍的:

Octane boots your application once, keeps it in memory, and then feeds it requests at supersonic speeds.

我们知道,Laravel 框架一直很优秀,但是他在性能方面却一直为人诟病。框架的 boot 时间可能比业务处理时间还长,并且随着项目第三方 service provider 的增多,其启动速度越来越不受控。而 Laravel Octane 则通过启动 Application 一次,常驻内存的方式来加速我们的应用。

Laravel Octane 需要 PHP8.0 支持,如果你是在 macOS 下工作,你可以参考这篇文章来更新你的 PHP 版本 Upgrade to PHP 8 with Homebrew on Mac

Octane 简单示列

虽说官方文档已经描述的很详细,不过作者这里还是通过一个简单的示列项目来演示。

Create Laravel Application

➜ laravel new laravel-octane-test

 _                               _
| |                             | |
| |     __ _ _ __ __ ___   _____| |
| |    / _` | '__/ _` \ \ / / _ \ |
| |___| (_| | | | (_| |\ V /  __/ |
|______\__,_|_|  \__,_| \_/ \___|_|

Creating a "laravel/laravel" project at "./laravel-octane-test"
Installing laravel/laravel (v8.5.16)
...
Application ready! Build something amazing.

Install Laravel Octane

$ composer require laravel/octane

安装成功后,读者可以直接执行 artisan octane:install 来安装依赖;Octane 将提示你想使用的 server 类型。

➜ php artisan octane:install

 Which application server you would like to use?:
  [0] roadrunner
  [1] swoole
 >

如果你选择的是 RoadRunner,程序将会自动帮你安装 RoadRunner 所需的依赖;而如果你选择的是 Swoole,你只需要确保你已经手动安装了 PHP swoole 扩展。

使用 RoadRunner Server

RoadRunner 的使用过程不尽人意,作者在安装过程中总会出现一些官方文档忽视的错误。

下载 rr 可执行文件失败

在执行 octane:install 安装 RoadRunner 依赖时,作者本机根本无法通过 GitHub 下载 rr 可执行文件,提示的错误如下:

In CommonResponseTrait.php line 178:

HTTP/2 403  returned for "https://api.github.com/repos/spiral/roadrunner-binary/releases?page=1".

如果你也遇到了这样的错误,建议直接去 RoadRunner 官网 下载对应平台的 rr 可执行文件及 .rr.yaml 配置文件并放到项目根目录。如 macOS 平台的可执行文件及配置文件地址:

最后记得修改 rr 的可执行权限及 RoadRunner 的 Worker starting command。

chmod +x ./rr
server:
  # Worker starting command, with any required arguments.
  #
  # This option is required.
  command: "php artisan octane:start --server=roadrunner --host=127.0.0.1 --port=8000"

ssl_valid: key file ‘/ssl/server.key’ does not exists

RoadRunner 的配置文件中,默认开启了 ssl 配置, 若你不需要启用 https 访问,可注释 http.ssl 配置。

Error while dialing dial tcp 127.0.0.1:7233

RoadRunner 默认开启 temporal 特性,其 listen 端口为 7233,若你不想启用该特性,可注释 temporal 配置。

# Drop this section for temporal feature disabling.
temporal:

关于 temporal 的信息可查看官网 temporalio/sdk-php: Temporal PHP SDK

Executable file not found in $PATH

这种情况一般是配置文件中未制定程序执行路径,请检查以下配置。

  1. Server.command

修改为 RoadRunner worker 的启动命令,如:

php artisan octane:start —server=roadrunner —host=127.0.0.1 —port=8000
  1. Service.some_service_*.comment

如果你不想使用该特性,注释该配置。至此,作者的 RoadRunner 终于启动起来了。

Laravel Octane RoadRunner

AB Test For RoadRunner

作者用自己的笔记本(2018-13inch/2.3GHz/16GB)做了一个简单的 AB Test,框架代码未做任何改动,为 Laravel 默认的 welcome 页面。

经过改变不同的并发参数和请求数,得到的结果都如下图所示上下轻微波动,其 QPS 基本维持在 230/s 左右。

~ ab -n 2000 -c 8 http://127.0.0.1:8000/
Server Software:
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /
Document Length:        17490 bytes

Concurrency Level:      8
Time taken for tests:   8.418 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      37042000 bytes
HTML transferred:       34980000 bytes
Requests per second:    237.59 [#/sec] (mean)
Time per request:       33.671 [ms] (mean)
Time per request:       4.209 [ms] (mean, across all concurrent requests)
Transfer rate:          4297.28 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        3   11   4.6     11      29
Processing:     3   20  34.8     15     270
Waiting:        3   18  34.8     12     270
Total:          7   31  35.2     25     284

默认情况下,Laravel 的 welcome 页面会先经过 web 中间件,最后在渲染 blade 页面;而 web 中间件包含大量 Cookie 和 Session 操作:

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
    ],
];

所以作者重新定义了一个测试路由,该路由不包含任何中间件(全局除外),并只输出一个 Hello World。

// RouteServiceProvider.php
public function boot()
{
    require base_path('routes/test.php');
}

// test.php
Route::get('/_test', function () {
    return 'Hello World';
});

再次测试后如下,可以看到其 QPS 已经达到官方宣传标准 2300/s(难道官方测试也是这样 Remove All Middleware?)。

Server Software:
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /_test
Document Length:        11 bytes

Concurrency Level:      8
Time taken for tests:   0.867 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      374000 bytes
HTML transferred:       22000 bytes
Requests per second:    2307.81 [#/sec] (mean)
Time per request:       3.466 [ms] (mean)
Time per request:       0.433 [ms] (mean, across all concurrent requests)
Transfer rate:          421.45 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0    0   0.1      0       3
Processing:     1    3   8.8      2     143
Waiting:        1    3   8.8      2     142
Total:          1    3   8.8      2     143

上述测试过程中,作者本机的资源限制如下。

~ ulimit -n
256

使用 Swoole Server

Swoole server 的使用就要顺畅多了;通过 pecl 安装好 PHP swoole 扩展后,无需任何配置就能启动。

Laravel Swoole

AB Test For Swoole Server

作者用同样的配置对 swoole server 进行 AB Test,结果如下,其 QPS 也基本维持在 230/s 左右。

Server Software:        swoole-http-server
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /
Document Length:        17503 bytes

Concurrency Level:      8
Time taken for tests:   8.398 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      37130000 bytes
HTML transferred:       35006000 bytes
Requests per second:    238.15 [#/sec] (mean)
Time per request:       33.592 [ms] (mean)
Time per request:       4.199 [ms] (mean, across all concurrent requests)
Transfer rate:          4317.61 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        3   11   6.6     10     102
Processing:     4   20  50.3     12     442
Waiting:        2   18  50.3     11     441
Total:          7   30  50.9     23     450

无中间件路由测试结果如下,可以看到其 QPS 已达到了 1650/s。

Server Software:        swoole-http-server
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /_test
Document Length:        21 bytes

Concurrency Level:      8
Time taken for tests:   1.212 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      528000 bytes
HTML transferred:       42000 bytes
Requests per second:    1650.63 [#/sec] (mean)
Time per request:       4.847 [ms] (mean)
Time per request:       0.606 [ms] (mean, across all concurrent requests)
Transfer rate:          425.55 [Kbytes/sec] received

从 AB Test 结果来看,两种 Server 的性能基本持平;但由于是在本地开发环境测试,未考虑到的因素较多,测试结果仅供参考。

部署上线

Laravel Octane 虽然提供了 start 命令用于启动 Server,但该命令只能在前台运行(不支持 -d);在部署到生产环境时,常见的办法还是利用 Supervisor 来进行进程管理。读者可以参考 Laravel Sail 的 Supervisor 配置。

[program:php]
command=/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=127.0.0.1 --port=80
user=sail
environment=LARAVEL_SAIL="1"
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

后续持续交付时,可通过 Jenkins 连接到服务节点,使用 octane:reload 命令重新加载服务。

stage("部署 ${ip}") {
    withCredentials([sshUserPrivateKey(credentialsId: env.HOST_CRED, keyFileVariable: 'identity')]) {
        remote.user = "${env.HOST_USER}"
        remote.identityFile = identity
        sshCommand remote: remote, command: "php artisan config:cache && php artisan route:cache && php artisan octane:reload"
    }
}

不过这里需要注意的是,当你更新了 Composer 依赖,如新增了一个第三方包时,你最好在生产环境重启下 Laravel Octane。

sudo supervisorctl -c /etx/supervisorctl.conf restart program:php

否则可能会出现如 Class “Godruoyi\Snowflake\Snowflake” not found 的错误。

Laravel Octane 是线程安全的吗?

在回答这个问题之前,我们先来看看 Laravel Octane 的请求处理流程。

Laravel Octane

随着 Server 的启动,程序会创建指定数量的 Worker 进程。当请求到来时,会从可用的 Worker 列表中选取一个并交由他处理。每个 Worker 同一时刻只能处理一个请求,在请求处理过程中,对资源(变量/静态变量/文件句柄/链接)的修改并不会存在竞争关系,所以 Laravel Octane 是线程(进程)安全的。

这其实和 FPM 模型是一致的,不同的地方在于 FPM 模型在处理完一个请求后,会销毁该请求申请的所有内存;后续请求到来时,依然要执行完整的 PHP 初始化操作(参考 PHP-FPM 启动分析)。而 Laravel Octane 的初始化操作是随着 Worker Boot 进行的,在整个 Worker 的生命周期内,只会进行一次初始操作(程序启动的时候)。后续请求将直接复用原来的资源。如上图,Worker Boot 完成后,将会初始化 Laravel Application Container,而后续的所有请求,都将复用该 App 实例。

Laravel Octane 工作原理

Octane 只是一个壳,真正处理请求都是由外部的 Server 处理的。不过 Octane 的设计还是值得一说的。

从源码也可以看出,随着 Worker 的 Boot 完成,Laravel Application 已被成功初始化。

// vendor/laravel/octane/src/Worker.php
public function boot(array $initialInstances = []): void
{
    $this->app = $app = $this->appFactory->createApplication(
        array_merge(
            $initialInstances,
            [Client::class => $this->client],
        )
    );

    $this->dispatchEvent($app, new WorkerStarting($app));
}

在处理后续到来的请求时,Octane 通过 clone $this->app 获取一个沙箱容器。后续的所有操作都是基于这个沙箱容器来进行的,不会影响到原有的 Container。在请求结束后,Octane 会清空沙箱容器并 unset 不再使用的对象。

public function handle(Request $request, RequestContext $context): void
{
    CurrentApplication::set($sandbox = clone $this->app);

    try {
        $response = $sandbox->make(Kernel::class)->handle($request); 

    } catch (Throwable $e) {
        $this->handleWorkerError($e, $sandbox, $request, $context, $responded);
    } finally {
        $sandbox->flush();

        unset($gateway, $sandbox, $request, $response, $octaneResponse, $output);

        CurrentApplication::set($this->app);
    }
}

再次注意,由于同一个 Worker 进程同一时刻只能处理一个请求,故这里是不存在竞争的,即使是对 static 变量的修改,也是安全的。

注意事项 & 第三方包适配

由于同一个 Worker 的多个请求会共享同一个容器实例,所以在向容器中注册单例对象时,应该特别小心。如下面的例子:

public function register()
{
    $this->app->singleton(Service::class, function ($app) {
        return new Service($app['request']);
    });
}

例子中采用 singleton 注册一个单例对象 Service,当该对象在某个 Provider 的 Boot 方法被初始化时,应用容器中将始终保持着唯一的 Service 对象;后续 Worker 在处理的其他请求时,从 Service 中获取的 request 对象将是相同的。

解决方法是你可以换一种绑定方式,或者使用闭包。最值得推荐的办法是只传入你需要的请求信息。

use App\Service;

$this->app->bind(Service::class, function ($app) {
    return new Service($app['request']);
});

$this->app->singleton(Service::class, function ($app) {
    return new Service(fn () => $app['request']);
});

// Or...

$service->method($request->input('name'));

强烈推荐读者阅读官方提出的注意事项。如果你觉得文章对你有帮助,你也可以订阅作者的博客 RSS 或直接访问作者博客 二愣的闲谈杂鱼

参考

本作品采用《CC 协议》,转载必须注明作者和本文链接
二愣的闲谈杂鱼
附言 1  ·  2年前

更新了去除中间件的测试结果,读者也可以点击评论查看 博客:Laravel Octane 初体验

本帖由系统于 2年前 自动加精
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 53
游离不2

每个 Worker 同一时刻只能处理一个请求

这个确定吗?

2年前 评论
godruoyi (楼主) 2年前
游离不2 (作者) 2年前
godruoyi (楼主) 2年前

正式版不知道支持 WS 不。我有用过,扣去网络(ping)平均 25 ms 延迟之外,其他的由 8ms 缩短到4 ms,也就是客户在 29 ms 收到结果(简单的 date('Y-m-d'))。下次试试其他复杂的功能看看

2年前 评论
godruoyi (楼主) 2年前
小李世界 (作者) 2年前
godruoyi (楼主) 2年前
小李世界 (作者) 2年前
CodingHePing

兼容了协程才爽

2年前 评论

帅,看来也得整整玩玩

2年前 评论
godruoyi (楼主) 2年前
godruoyi

默认情况下,Laravel 的 welcome 页面会先经过 web 中间件,最后在渲染 blade 页面;而 web 中间件包含大量 Cookie 和 Session 操作:

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
    ],
];

所以作者重新定义了一个测试路由,该路由不包含任何中间件(全局除外),并只输出一个 Hello World。

// RouteServiceProvider.php
public function boot()
{
    require base_path('routes/test.php');
}

// test.php
Route::get('/_test', function () {
    return 'Hello World';
});

再次测试后如下,可以看到其 QPS 已经达到官方宣传标准 2300/s(难道官方测试也是这样 Remove All Middleware?)。

RoadRunner 无中间件测试结果

$ ab -n 2000 -c 8 http://127.0.0.1:8000/_test

Server Software:
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /_test
Document Length:        11 bytes

Concurrency Level:      8
Time taken for tests:   0.867 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      374000 bytes
HTML transferred:       22000 bytes
Requests per second:    2307.81 [#/sec] (mean)
Time per request:       3.466 [ms] (mean)
Time per request:       0.433 [ms] (mean, across all concurrent requests)
Transfer rate:          421.45 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0    0   0.1      0       3
Processing:     1    3   8.8      2     143
Waiting:        1    3   8.8      2     142
Total:          1    3   8.8      2     143

上述测试过程中,作者本机的资源限制如下。

~ ulimit -n
256

Swoole 无中间件测试结果

$ ab -n 2000 -c 8 http://127.0.0.1:8000/_test

Server Software:        swoole-http-server
Server Hostname:        127.0.0.1
Server Port:            8000

Document Path:          /_test
Document Length:        21 bytes

Concurrency Level:      8
Time taken for tests:   1.212 seconds
Complete requests:      2000
Failed requests:        0
Total transferred:      528000 bytes
HTML transferred:       42000 bytes
Requests per second:    1650.63 [#/sec] (mean)
Time per request:       4.847 [ms] (mean)
Time per request:       0.606 [ms] (mean, across all concurrent requests)
Transfer rate:          425.55 [Kbytes/sec] received
2年前 评论
黑将军 2年前
nff93

@godruoyi 建议也把你的 ab 参数贴出来

2年前 评论
godruoyi (楼主) 2年前

我本地搭建的octane也是达不到官方的QPS,不过我是安装在虚拟机里测试的。

2年前 评论
DonnyLiu

mark。

2年前 评论

QPS 首先要看的机器,其次,官方给到的是框架的裸跑性能提升对比。我提过并发的问题,官方的回答是,这个扩展包目前仅能提升IO性能,并不能提升QPS(比如你添加了额外的业务逻辑,可能会发现QPS反而降低了),不支持协程(再未来的版本会考虑),最好还是等LTS出来后用于生产

2年前 评论
godruoyi (楼主) 2年前
李铭昕 2年前
李铭昕 2年前
李铭昕 2年前

我测了下,用了roadrunner比没用性能还差,这是什么鬼

2年前 评论
godruoyi (楼主) 2年前

file 插个话题为什么没个请求都会去请求/session/init file 我把中间件的session禁了也还是会有

2年前 评论
Imuyu 2年前

这么看,一般的 Web 项目用 Octane 并不会得到性能提升。那么 Octane 的应用场景是啥呢。

2年前 评论
myhui0926 2年前
wanghan 2年前
第五焱陽

mark 有空尝试下

2年前 评论

并发和常规项目的对比怎么样?

2年前 评论
godruoyi (楼主) 2年前

相信laravel团队的能力,期待。。。。 让我们荡起双桨

2年前 评论
json991

很奇怪,在本地进行abtest 没效果

file

file 求大神指点

2年前 评论
godruoyi (楼主) 2年前

我用supervisor,如果发生内在泄漏报错,Supervisor会显示已经停止,然后偿试重启,但会提示已经在运行无法再启动 这个问题不知道你们有没有碰到过,官方不知道会不会解决 200 POST /app/buyer/tasks/dispatcher/3327 ............... 6.73 mb 15.45 ms

Symfony\Component\ErrorHandler\Error\FatalError

Allowed memory size of 209715200 bytes exhausted (tried to allocate 192938352 bytes)

at vendor/symfony/process/Process.php:600 596▕ public function getIncrementalOutput() 597▕ { 598▕ $this->readPipesForOutput(FUNCTION); 599▕ ➜ 600▕ $latest = stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset); 601▕ $this->incrementalOutputOffset = ftell($this->stdout); 602▕ 603▕ if (false === $latest) { 604▕ return '';

Whoops\Exception\ErrorException

Allowed memory size of 209715200 bytes exhausted (tried to allocate 192938352 bytes)

at vendor/symfony/process/Process.php:600 596▕ public function getIncrementalOutput() 597▕ { 598▕ $this->readPipesForOutput(FUNCTION); 599▕ ➜ 600▕ $latest = stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset); 601▕ $this->incrementalOutputOffset = ftell($this->stdout); 602▕ 603▕ if (false === $latest) { 604▕ return '';

  [2m+1 vendor frames [22m

2 [internal]:0 Whoops\Run::handleShutdown()

ERROR Server is already running.

ERROR Server is already running.

ERROR Server is already running.

ERROR Server is already running.

2年前 评论

有没有用 swoole 报错的?

Class "Swoole\Http\Server" not found

  at vendor/laravel/octane/bin/createSwooleServer.php:6
      23$config = $serverState['octaneConfig'];
      45try {6$server = new Swoole\Http\Server(
      7$serverState['host'] ?? '127.0.0.1',
      8$serverState['port'] ?? '8080',
      9SWOOLE_PROCESS,
     10SWOOLE_SOCK_TCP,
2年前 评论
大胆的番茄 (作者) 2年前

如果后面的同学在启动mysql时遇到了如下报错

MYSQL_USER="root", MYSQL_USER and MYSQL_PASSWORD are for configuring a regular user and cannot be used for the root user

可以把dockerfile中的MYSQL_USER: '${DB_USERNAME}'注释,位置如下 ```` ... mysql: image: 'mysql:8.0' ports: - '${FORWARD_DB_PORT:-3306}:3306' environment: MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}' MYSQL_DATABASE: '${DB_DATABASE}'

        # MYSQL_USER: '${DB_USERNAME}'
        MYSQL_PASSWORD: '${DB_PASSWORD}'
        MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'

... ``` 因为会自动创建root用户,所以这里要注释

2年前 评论

新项目可以考虑使用起来,老项目要用的话想想就头大

2年前 评论

MacOS下测试了,没官方说的那么高。配置M1 + 16g。只是输出了hello world。

file

很不稳定,最高的一次1070。
最低600。

同一个机器,用java的springboot + mybatis-plus,还查了数据库列表,能到4000+;
用golang的gin + gorm 到6000+。

:sob:

2年前 评论
深蓝色 2年前
nff93 2年前

本地进行测试的时候,确实 qps 提升了 6-10倍不等,但是真正上线了,发现了,一点没有提升,具体原因还没有深究,不知道有清楚的大佬给解答一下不

11个月前 评论

如何指定域名继续访问? 映射了服务器IP 后, 只能 tools.test:8000 访问。 请教下, 如何 使用于域名访问, 不用加额外端口?

file

file

file

7个月前 评论
godruoyi (楼主) 7个月前
Latent 7个月前

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!