Laravel Octane 2026完全ガイド：SwooleとRoadRunnerによるパフォーマンス最適化

return [
    'server' => env('OCTANE_SERVER', 'swoole'),
    
    'https' => env('OCTANE_HTTPS', false),
    
    'listeners' => [
        WorkerStarting::class => [
            EnsureUploadedFilesAreValid::class,
            EnsureUploadedFilesCanBeMoved::class,
        ],
        RequestReceived::class => [
            // リクエスト受信時のカスタムリスナー
        ],
        RequestHandled::class => [
            // レスポンス送信後のクリーンアップ
        ],
    ],
    
    'warm' => [
        // 起動時にプリロードするサービス
        App\Services\HeavyService::class,
        App\Repositories\CachedRepository::class,
    ],
    
    'flush' => [
        // リクエストごとにリセットするサービス
    ],
    
    'workers' => env('OCTANE_WORKERS', 'auto'),
    'task_workers' => env('OCTANE_TASK_WORKERS', 'auto'),
    'max_requests' => env('OCTANE_MAX_REQUESTS', 1000),
    'tick' => true,
    'tick_interval' => 10000, // 10秒
];

// Swooleコルーチンを使用した並行処理
use Swoole\Coroutine;
use function Swoole\Coroutine\run;

run(function () {
    $results = [];
    
    // 3つのAPIコールを並行実行
    Coroutine\go(function () use (&$results) {
        $results['users'] = Http::get('https://api.example.com/users')->json();
    });
    
    Coroutine\go(function () use (&$results) {
        $results['orders'] = Http::get('https://api.example.com/orders')->json();
    });
    
    Coroutine\go(function () use (&$results) {
        $results['products'] = Http::get('https://api.example.com/products')->json();
    });
    
    // 全てのコルーチンが完了するまで待機
    // 総時間 = max(各リクエスト時間) ≒ 200ms（直列実行なら600ms）
});

# .rr.yaml - RoadRunner設定ファイル
version: '3'

server:
  command: 'php artisan octane:start --server=roadrunner --host=0.0.0.0 --port=8000'

http:
  address: 0.0.0.0:8000
  middleware:
    - gzip
    - headers
  pool:
    num_workers: 8
    max_jobs: 1000
    supervisor:
      max_worker_memory: 128  # MB
      exec_ttl: 60s

jobs:
  pool:
    num_workers: 4

kv:
  local:
    driver: memory
    config:
      interval: 60

// 危険な実装 - 状態が漏洩する
class UserContextService
{
    private ?User $currentUser = null;
    
    public function setUser(User $user): void
    {
        $this->currentUser = $user; // 次のリクエストでも残る
    }
    
    public function getUser(): ?User
    {
        return $this->currentUser;
    }
}

// 安全な実装 - Octane互換
class UserContextService
{
    public function setUser(User $user): void
    {
        // リクエストスコープの属性を使用
        request()->attributes->set('current_user', $user);
    }
    
    public function getUser(): ?User
    {
        return request()->attributes->get('current_user');
    }
}

use Laravel\Octane\Facades\Octane;
use Laravel\Octane\Events\RequestReceived;
use Laravel\Octane\Events\RequestTerminated;

class OctaneServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // リクエスト開始時にリセットが必要なサービス
        Octane::listen(RequestReceived::class, function ($event) {
            // ロケールをリセット
            app()->setLocale(config('app.locale'));
            
            // カスタムサービスをリセット
            app(TenantService::class)->reset();
        });
        
        // リクエスト終了時のクリーンアップ
        Octane::listen(RequestTerminated::class, function ($event) {
            // 大きなオブジェクトを解放
            gc_collect_cycles();
        });
    }
}

use Laravel\Octane\Facades\Octane;

public function getDashboardData(): array
{
    // 3つのクエリを並行実行
    [$users, $orders, $revenue] = Octane::concurrently([
        fn () => User::where('active', true)->count(),
        fn () => Order::whereDate('created_at', today())->get(),
        fn () => Payment::whereMonth('created_at', now()->month)->sum('amount'),
    ]);
    
    return compact('users', 'orders', 'revenue');
}

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
    // Octane用の接続プール設定
    'pool' => [
        'min_connections' => 1,
        'max_connections' => 10,
        'wait_timeout' => 3.0,
        'max_idle_time' => 60.0,
    ],
],

use Laravel\Octane\Facades\Octane;

Octane::route('GET', '/ws', function ($request) {
    return Octane::webSocket($request, function ($ws) {
        $ws->on('open', function ($connection) {
            logger()->info('WebSocket connection opened', [
                'id' => $connection->fd,
            ]);
        });
        
        $ws->on('message', function ($connection, $data) {
            // ブロードキャスト
            broadcast(new MessageReceived($data));
        });
        
        $ws->on('close', function ($connection) {
            logger()->info('WebSocket connection closed');
        });
    });
});

# Dockerfile - Octane用のDockerfile
FROM php:8.4-cli-alpine

# Swoole拡張のインストール
RUN apk add --no-cache $PHPIZE_DEPS linux-headers \
    && pecl install swoole \
    && docker-php-ext-enable swoole

# アプリケーションのコピー
COPY . /var/www/html
WORKDIR /var/www/html

# Composerの依存関係インストール
RUN composer install --no-dev --optimize-autoloader

# キャッシュの最適化
RUN php artisan config:cache \
    && php artisan route:cache \
    && php artisan view:cache

# Octaneサーバーの起動
CMD ["php", "artisan", "octane:start", "--server=swoole", "--host=0.0.0.0", "--port=8000"]

# docker-compose.yml - 本番環境構成
version: '3.8'

services:
  app:
    build: .
    ports:
      - "8000:8000"
    environment:
      - APP_ENV=production
      - OCTANE_SERVER=swoole
      - OCTANE_WORKERS=8
      - OCTANE_MAX_REQUESTS=1000
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
    deploy:
      replicas: 3
      resources:
        limits:
          cpus: '2'
          memory: 512M