🚀 Topic 21: Laravel Octane

# Install Laravel Octane
composer require laravel/octane

# Install Swoole (recommended for performance)
composer require swoole/php-ext
sudo pecl install swoole

# OR install RoadRunner (easier)
php artisan octane:install --server=roadrunner

# Start Octane
php artisan octane:start --server=swoole --port=8000

# Run with multiple workers
php artisan octane:start --server=swoole --workers=4 --task-workers=2

• Avoid static properties that grow over time
• Avoid global variables — use request context instead
• Use Cache with TTL instead of in-memory arrays
• Reset singletons manually if they accumulate state
• Use Octane's request lifecycle events to clean up
• Monitor memory with `octane:status` command
• Restart Octane periodically (e.g., daily) to clear leaks

return [
    // Server type (swoole or roadrunner)
    'server' => env('OCTANE_SERVER', 'swoole'),
    
    // Number of workers (CPU cores * 1-2)
    'workers' => env('OCTANE_WORKERS', 4),
    
    // Number of task workers (for async tasks)
    'task_workers' => env('OCTANE_TASK_WORKERS', 2),
    
    // Max request size (bytes)
    'max_request_size' => env('OCTANE_MAX_REQUEST_SIZE', 10 * 1024 * 1024),
    
    // Listen on all interfaces
    'host' => env('OCTANE_HOST', '0.0.0.0'),
    
    // Port (use 80 with reverse proxy)
    'port' => env('OCTANE_PORT', 8000),
    
    // Reload workers after N requests (like pm.max_requests)
    'max_requests' => env('OCTANE_MAX_REQUESTS', 1000),
    
    // Watch for file changes (disable in production)
    'watch' => env('OCTANE_WATCH', false),
    
    // Swoole specific
    'swoole' => [
        'options' => [
            'enable_coroutine' => false,  // Disable for Laravel
            'open_http2_protocol' => true,
            'http_compression' => true,
        ],
    ],
    
    // RoadRunner specific
    'roadrunner' => [
        'options' => [
            'http' => [
                'middleware' => ['static', 'gzip'],
            ],
        ],
    ],
];

# /etc/supervisor/conf.d/octane.conf

[program:octane]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/artisan octane:start --server=swoole --workers=4 --task-workers=2 --max-requests=1000
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=forge
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/storage/logs/octane.log
stopwaitsecs=3600

[program:octane-watcher]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/artisan octane:reload
autostart=true
autorestart=true
user=forge
numprocs=1

# /etc/nginx/sites-available/example.com

server {
    listen 80;
    server_name example.com;
    
    # Proxy all requests to Octane
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
    
    # Static files still served by Nginx
    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|woff|woff2)$ {
        root /var/www/example.com/public;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}