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