$30 off During Our Annual Pro Sale. View Details »

Running Laravel Apps With FrankenPHP

Running Laravel Apps With FrankenPHP

Here are the slides from the conference I gave at Laracon EU 2023.

Kévin Dunglas

February 28, 2024
Tweet

More Decks by Kévin Dunglas

Other Decks in Programming

Transcript

  1. ➔ PHP API Platform creator, Symfony Core Team, Occasional Laravel

    contributor ➔ Go Mercure.rocks creator, Caddy maintainer, Go core contributor ➔ C PHP core contributor Kévin Dunglas: Polyglot Dev @dunglas
  2. Web and Cloud Experts ➔ Web development (PHP, JS, Go,

    Rust...) ➔ Support & hosting (FrankenPHP) apps ➔ Consultancy & maintenance ➔ UX & UI design ➔ [email protected] 💌
  3. FrankenPHP A modern app server for Laravel and PHP apps:

    ➔ Replaces NGINX+FPM or Apache+mod_php ➔ Built for easy deployments: compatible with Forge and Docker, can embed your app in the binary! ➔ The fastest Laravel Octane engine ➔ 103 Early Hints support ➔ Built-in Laravel Broadcast support (Mercure) ➔ Compatible with all existing PHP apps: progressive enhancement
  4. ➔ Super simple to use: ◆ Standalone binary (that can

    contain your app) ◆ No external dependencies ◆ Batteries included ➔ Built on top of the Caddy web server ◆ All Caddy features and modules ◆ Benefits from Go features ◆ Extensible: in Go, in C, in PHP ➔ Designed for prod, CI and dev envs FrankenPHP: Modern PHP App Server
  5. ➔ Standalone Go library: calls libphp (the official PHP engine

    as a C library) using cgo ➔ Embed PHP in any Go program (static build) ➔ New SAPI for Go net/http ◆ Caddy, Traefik, Kubernetes… ◆ Your custom Go app ➔ Caddy module using the library ➔ Unique features The ❤ of FrankenPHP
  6. FrankenPHP: Features BROTLI, ZSTANDARD & GZIP COMPRESSION Modern compression formats

    are supported out-of-the-box. STRUCTURED LOGGING Bring a more defined format and details to your logging. PROMETHEUS METRICS & TRACING Built-in Prometheus support! HTTP/2 & HTTP/3 Native support for HTTPS, HTTP/2 and HTTP/3. HTTPS AUTOMATION Automatic HTTPS certificate generation, renewal and revocation. GRACEFUL RELOAD Deploy your apps with zero downtime thanks to graceful reloads.
  7. ➔ Compatible with existing PHP apps (including Laravel, Symfony and

    even WordPress)! 🐘 ➔ Static binary ✨ ➔ Single Docker image 🐳 ➔ Entirely configurable 💅 ◆ Caddyfile ◆ php.ini ➔ Free software (as in free speech ✊, and free beer 🍺) FrankenPHP: At a Glance
  8. FrankenPHP Superpower: The Worker Mode ➔ A new engine for

    Laravel Octane ➔ Boot your application once ➔ Keep it in memory ➔ Process incoming requests without having to boot your app again ➔ Relies on goroutines and channels ➔ Somewhat similar to RoadRunner ➔ Unlike RoadRunner ◆ runs in process: no network calls, no gRPC ◆ uses plain old superglobals: no PSR-7
  9. FrankenPHP for Octane # Install $ composer require laravel/octane $

    php artisan octane:install \ --server=frankenphp # Run $ php artisan octane:start
  10. FrankenPHP for Octane: HTTPS # Generates (and renew) a TLS

    certificate # Starts an HTTPS server # supporting HTTP/1, HTTP/2, HTTP/3 # and Early Hints php artisan octane:start \ --host=example.com \ --port=443 \ --admin-port=2019
  11. FrankenPHP for Octane: Benchmark 🧪 # Concurrency 1 for 5

    seconds… ./vendor/bin/pest stress http://127.0.0.1:8000 Swoole Medium Request Duration ........... 4.94 ms RoadRunner Medium Request Duration ....... 2.61 ms FrankenPHP Medium Request Duration ....... 0.88 ms # Concurrency 8 for 5 seconds… ./vendor/bin/pest stress http://127.0.0.1:8000 --concurrency=8 Swoole Medium Request Duration ........... 5.39 ms RoadRunner Medium Request Duration ....... 4.00 ms FrankenPHP Medium Request Duration ....... 1.59 ms Benchmark by Nuno Maduro using Pest’s stress testing plugin on a M1 pro.
  12. Early Hints: Supported by FrankenPHP ⚡ header('Link: </style.css>; rel=preload; as=style');

    headers_send(103); // Your slow algorithms and SQL queries 🤪 echo <<<'HTML' <!DOCTYPE html> <title>Hello FrankenPHP</title> <link rel="stylesheet" href="style.css"> HTML;
  13. Early Hints: Laravel + FrankenPHP ⚡ Route::get('/', function () {

    $r = new Response(); $r->headers->set('Link', '</style.css>; rel=preload; as=style'); $r->sendHeaders(103); // Your slow algorithms and SQL queries 🤪 $r->setContent('The result of your computations'); return $r; });
  14. Octane: Enable The Mercure Hub // config/octane.php return [ //

    ... 'mercure'=> [ 'publisher_jwt' => 'MySecret', 'subscriber_jwt' => 'MySecret', 'anonymous' => true, ], ];
  15. Broadcasting: Add The Mercure Provider // composer require mvanduijker/laravel-mercure-broadcaster //

    config/broadcasting.php return [ 'default' => 'mercure', 'connections' => [ 'mercure' => [ 'driver' => 'mercure', 'url' => 'http://127.0.0.1:8000/.well-known/mercure', 'secret' => 'MySecret', ], ] ];
  16. Broadcasting: Create an Event namespace App\Events; use Duijker\LaravelMercureBroadcaster\Broadcasting\Channel; use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;

    class ThingDone implements ShouldBroadcastNow { public function __construct(public string $foo) {} public function broadcastOn(): Channel { return new Channel('things_done'); } }
  17. Broadcasting: Subscribe and Dispatch // Subscribe in the browser, no

    3rd-party lib required! // Compatible with Livewire and all JS frameworks const eventSource = new EventSource( '/.well-known/mercure?topic=things_done' ); eventSource.onmessage = e => console.log(e); // From Laravel: broadcast the event event(new ThingDone('foo'));
  18. A standalone Laravel App: We’ll create a static binary containing:

    ➔ A web server (Caddy) ➔ PHP (and its dependencies) ➔ The extensions we need (and their dependencies) ➔ FrankenPHP ➔ Our Laravel and PHP app ➔ The dependencies of our Laravel app ➔ Our assets
  19. Laravel App As a Standalone Binary # Prepare your app

    $ composer install --no-dev -a $ php artisan [config|event|route]:cache # Build $ git clone https://github.com/dunglas/frankenphp && cd frankenphp $ EMBED=/path/to/my/laravel/app ./build-static.sh # Run in standard mode 🎉 $ ./dist/frankenphp-<os>-<arch> php-server # Run with Octane 🎉🎉🎉 $ ./dist/frankenphp-<os>-<arch> php-cli artisan octane:start
  20. Meet our team and get FrankenPHP swag (or a beer)

    at our booth! Thanks! frankenphp.dev @dunglas Want to know more about FrankenPHP or how Les-Tilleuls.coop can help you?