FrankenPHP: Application Server Thay Thế Nginx + PHP-FPM Trong Tương Lai

<?php
// 1. Boot ứng dụng một lần duy nhất
$app = require __DIR__ . '/bootstrap/app.php';

// 2. Handler xử lý từng request
$handler = static function () use ($app) {
    try {
        $kernel   = $app->make(Illuminate\Contracts\Http\Kernel::class);
        $request  = Illuminate\Http\Request::capture();
        $response = $kernel->handle($request);
        $response->send();
        $kernel->terminate($request, $response);
    } catch (\Throwable $e) {
        // Xử lý lỗi mà không crash worker
        http_response_code(500);
        echo 'Internal Server Error';
    }
};

// 3. Vòng lặp xử lý request — app vẫn sống trong memory
$maxRequests = (int) ($_SERVER['MAX_REQUESTS'] ?? 0); // 0 = unlimited
for ($i = 0; !$maxRequests || $i < $maxRequests; $i++) {
    $keepRunning = \frankenphp_handle_request($handler);

    // Dọn dẹp giữa các request (memory leak prevention)
    gc_collect_cycles();

    if (!$keepRunning) break;
}
// Chú ý: $app được tạo 1 lần duy nhất ở trên — không tạo lại!

<?php
namespace App\Http\Controllers;

use Symfony\Component\HttpFoundation\Response;

class HomeController extends Controller {
    public function index(): Response {
        // Gửi 103 Early Hints — browser bắt đầu preload ngay
        // trong khi controller vẫn đang xử lý DB queries
        header('Link: </css/app.css>; rel=preload; as=style');
        header('Link: </js/app.js>; rel=preload; as=script');
        frankenphp_send_http_status(103); // Gửi 103 trước

        // Sau đó làm việc nặng...
        $data = $this->heavyDatabaseQuery();

        return view('home', $data); // 200 OK
    }
}

# Linux/macOS — 1 lệnh
curl -fsSL https://php.new/install/linux/8.4 | bash

# macOS với Homebrew
brew install dunglas/tap/frankenphp

# Windows (PowerShell)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

# Kiểm tra version
frankenphp version

# Serve thư mục hiện tại (tương tự php -S localhost:8000)
frankenphp php-server

# Serve với HTTPS tự ký (cho dev)
frankenphp php-server --domain localhost

# Chạy CLI script
frankenphp php-cli artisan migrate

# Với Worker Mode
frankenphp php-server --worker public/index.php

# Caddyfile — đặt ở root project
{
    frankenphp
    order php_server before file_server
}

# Domain tự động HTTPS
yourdomain.com {
    root * /app/public

    # Bật Worker Mode với 4 workers
    php_server {
        worker {
            file ./public/index.php
            num  4
        }
    }

    # Nén gzip/brotli tự động
    encode zstd br gzip

    # Cache static files
    @static {
        file
        path *.css *.js *.jpg *.png *.svg *.woff2
    }
    header @static Cache-Control "public, max-age=31536000"

    file_server
}

# Cài Laravel Octane
composer require laravel/octane

# Install với FrankenPHP driver
php artisan octane:install --server=frankenphp

# Chạy development server
php artisan octane:frankenphp

# Chạy với options
php artisan octane:frankenphp \
  --host=0.0.0.0 \
  --port=8000 \
  --workers=4 \
  --max-requests=500 \
  --https \
  --watch   # Hot reload khi file thay đổi

<?php
return [
    'server' => env('OCTANE_SERVER', 'frankenphp'),

    'frankenphp' => [
        'workers' => env('OCTANE_WORKERS', 'auto'), // auto = số CPU cores
        'max_requests' => env('OCTANE_MAX_REQUESTS', 500),
        'request_timeout' => env('OCTANE_TIMEOUT', 30),
    ],

    // Mercure real-time (tích hợp sẵn với FrankenPHP)
    'mercure' => [
        'url'             => env('MERCURE_URL', 'http://localhost/.well-known/mercure'),
        'public_url'      => env('MERCURE_PUBLIC_URL', 'https://yourdomain.com/.well-known/mercure'),
        'jwt_secret'      => env('MERCURE_JWT_SECRET', 'your-secret'),
        'jwt_algorithm'   => env('MERCURE_JWT_ALGORITHM', 'HS256'),
    ],
];

# Xem status workers
php artisan octane:status

# Reload workers (không downtime)
php artisan octane:reload

# Dừng server
php artisan octane:stop

# Xem logs realtime
php artisan octane:frankenphp --log-level=debug

# Serve thư mục hiện tại — HTTPS tự động
docker run -v .:/app/public \
  -p 80:80 -p 443:443 -p 443:443/udp \
  dunglas/frankenphp

# Với Worker Mode
docker run -v .:/app \
  -e FRANKENPHP_CONFIG="worker ./public/index.php" \
  -p 80:80 -p 443:443 \
  dunglas/frankenphp

FROM dunglas/frankenphp:latest-php8.4-alpine

# Cài PHP extensions cần thiết
RUN install-php-extensions \
    pdo_mysql \
    redis \
    opcache \
    intl \
    zip \
    gd

# PHP production settings
COPY docker/php.ini /usr/local/etc/php/conf.d/app.ini

# Copy app
WORKDIR /app
COPY . .

# Cài Composer dependencies
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
RUN composer install --no-dev --optimize-autoloader --no-interaction

# Laravel optimizations
RUN php artisan config:cache && \
    php artisan route:cache  && \
    php artisan view:cache   && \
    php artisan event:cache

# Quyền thư mục
RUN chown -R www-data:www-data storage bootstrap/cache

EXPOSE 80 443 443/udp

# Chạy với Worker Mode
ENV FRANKENPHP_CONFIG="worker ./public/index.php"
CMD ["frankenphp", "run", "--config", "/etc/caddy/Caddyfile"]

services:
  app:
    build: .
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"   # HTTP/3 qua UDP
    volumes:
      - ./storage:/app/storage
      - caddy_data:/data      # Caddy certs & state
      - caddy_config:/config
    environment:
      SERVER_NAME: "yourdomain.com"
      FRANKENPHP_CONFIG: "worker ./public/index.php num 4"
      APP_ENV: production
      DB_HOST: db
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_USER: laravel
      MYSQL_PASSWORD: secret
      MYSQL_ROOT_PASSWORD: rootsecret
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  caddy_data:
  caddy_config:
  mysql_data: