Laravel Octane

composer require laravel/octane

php artisan octane:install

pecl install swoole

pecl install openswoole

php artisan octane:start

php artisan octane:start --server=frankenphp
php artisan octane:start --server=roadrunner
php artisan octane:start --server=swoole

php artisan octane:start --workers=4

php artisan octane:start --workers=4 --task-workers=6

php artisan octane:start --watch

# 重新載入 worker（部署後執行）
php artisan octane:reload

# 停止伺服器
php artisan octane:stop

# 檢查伺服器狀態
php artisan octane:status

// ❌ 有問題的範例 — 舊容器被重複使用
$this->app->singleton(Service::class, function (Application $app) {
    return new Service($app);
});

// ✅ 安全的範例 — 透過閉包每次取得最新容器
$this->app->singleton(Service::class, function () {
    return new Service(fn () => Container::getInstance());
});

// ❌ 有問題的範例 — 舊的 request 被重複使用
$this->app->singleton(Service::class, function (Application $app) {
    return new Service($app['request']);
});

// ✅ 安全的範例 — 透過閉包每次取得最新的 request
$this->app->singleton(Service::class, function (Application $app) {
    return new Service(fn () => $app['request']);
});

// ✅ 最推薦 — 只傳入方法所需的值
$service->method($request->input('name'));

// ❌ 有問題的範例 — 即使設定值改變也仍使用舊的 repository
$this->app->singleton(Service::class, function (Application $app) {
    return new Service($app->make('config'));
});

// ✅ 安全的範例
$this->app->singleton(Service::class, function () {
    return new Service(fn () => Container::getInstance()->make('config'));
});

// ❌ 記憶體洩漏的範例 — $data 會隨著每次請求持續增長
class Service
{
    public static array $data = [];
}

public function index(Request $request): array
{
    Service::$data[] = Str::random(10);
    return [];
}

php artisan octane:start --max-requests=250

'max_execution_time' => 30,

use App\Models\User;
use App\Models\Server;
use Laravel\Octane\Facades\Octane;

[$users, $servers] = Octane::concurrently([
    fn () => User::all(),
    fn () => Server::all(),
]);

php artisan octane:start --workers=4 --task-workers=6

use Laravel\Octane\Facades\Octane;

// 每 10 秒執行一次
Octane::tick('delayed-ticker', fn () => ray('Ticking...'))
    ->seconds(10);

// 伺服器啟動時也立即執行
Octane::tick('immediate-ticker', fn () => ray('Ticking...'))
    ->seconds(10)
    ->immediate();

use Illuminate\Support\Facades\Cache;

Cache::store('octane')->put('framework', 'Laravel', 30);

use Illuminate\Support\Str;

Cache::store('octane')->interval('random', function () {
    return Str::random(10);
}, seconds: 5);

'tables' => [
    'example:1000' => [
        'name' => 'string:1000',
        'votes' => 'int',
    ],
],

use Laravel\Octane\Facades\Octane;

Octane::table('example')->set('uuid', [
    'name' => 'Nuno Maduro',
    'votes' => 1000,
]);

$row = Octane::table('example')->get('uuid');

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 80;
    server_name example.com;
    root /home/forge/example.com/public;

    location /index.php {
        try_files /not_exists @octane;
    }

    location / {
        try_files $uri $uri/ @octane;
    }

    location @octane {
        set $suffix "";

        if ($uri = /index.php) {
            set $suffix ?$query_string;
        }

        proxy_http_version 1.1;
        proxy_set_header Host $http_host;
        proxy_set_header Scheme $scheme;
        proxy_set_header SERVER_PORT $server_port;
        proxy_set_header REMOTE_ADDR $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;

        proxy_pass http://127.0.0.1:8000$suffix;
    }
}

[program:octane]
process_name=%(program_name)s_%(process_num)02d
command=php /home/forge/example.com/artisan octane:start --server=frankenphp --host=127.0.0.1 --port=8000
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/forge/example.com/storage/logs/octane.log
stopwaitsecs=3600

OCTANE_HTTPS=true

php artisan octane:reload

use Illuminate\Foundation\DevCommands;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        DevCommands::artisan('serve', 'server');
    }
}