Add documentation for FrankenPHP in classic and worker modes

Author: ioaniftimesei

README.md

@@ -65,8 +65,10 @@ We support Debian >= 11 and Ubuntu >= 20.04.
 You can run on Debian 10, by doing this setup before install: [Debian10 setup](./docs/debian10.md)
 
 #### Deployment setup
-- [Caddy & PHP-FPM](./docs/caddy.md)
+- [Caddy & PHP-FPM](./docs/caddy-php-fpm.md)
 - [Apache mod_php](./docs/apache-mod-php.md)
+- [FrannkenPHP classic](./docs/caddy-frankenphp-classic.md)
+- [FrannkenPHP worker](./docs/caddy-frankenphp-worker.md)
 
 #### Managed platforms
 - [Laravel Forge](./docs/laravel-forge.md)

docs/caddy-frankenphp-classic.md

@@ -0,0 +1,23 @@
+# FrankenPHP (Classic Mode)
+
+1. Pass the Aikido environment variables in your `Caddyfile`
+
+`Caddyfile`
+```
+example.com {
+    root * /var/www/html/public
+
+    php_server {
+        env AIKIDO_TOKEN "AIK_RUNTIME_...."
+        env AIKIDO_BLOCK "True"
+    }
+
+    file_server
+}
+```
+
+You can get your token from the [Aikido Security Dashboard](https://help.aikido.dev/doc/creating-an-aikido-zen-firewall-token/doc6vRJNzC4u).
+
+2. Start FrankenPHP
+
+`frankenphp run --config Caddyfile`

docs/caddy-frankenphp-worker.md

@@ -0,0 +1,47 @@
+# FrankenPHP (Worker Mode)
+
+1. Pass the Aikido environment variables to FrankenPHP in your `Caddyfile` and configure the worker
+
+`Caddyfile`
+```
+example.com {
+    root * /var/www/html/public
+
+    php_server {
+        env AIKIDO_TOKEN "AIK_RUNTIME_...."
+        env AIKIDO_BLOCK "True"
+        worker {
+            file /var/www/html/public/index.php
+            num 4
+        }
+    }
+
+    file_server
+}
+```
+
+You can get your token from the [Aikido Security Dashboard](https://help.aikido.dev/doc/creating-an-aikido-zen-firewall-token/doc6vRJNzC4u).
+
+2. Call `\aikido\worker_rinit()` and `\aikido\worker_rshutdown()` in your worker script
+
+Wrap your request handler with these calls to ensure Aikido processes each request.
+
+`public/index.php`
+```php
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+$app = require_once __DIR__ . '/../bootstrap/app.php';
+
+while (frankenphp_handle_request(function () use ($app) {
+    \aikido\worker_rinit();
+    // Your application logic
+    \aikido\worker_rshutdown();
+})) {
+    // keep looping
+}
+```
+
+3. Start FrankenPHP
+
+`frankenphp run --config Caddyfile`