Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
FrankenPHP sostituisce sia il tuo server web (Nginx, Apache) che PHP-FPM con un singolo binario. Questa guida copre una migrazione di base per una tipica applicazione PHP.
| Configurazione PHP-FPM | Equivalente FrankenPHP |
|---|---|
| Nginx/Apache + PHP-FPM | Singolo binario frankenphp |
Impostazioni pool php-fpm.conf | frankenphp opzione globale |
Blocco server {} di Nginx | Blocco sito Caddyfile |
php_value / php_admin_value | php_ini direttiva Caddyfile |
pm = static / pm.max_children | num_threads |
pm = dynamic | max_threads auto |
| Filtraggio richieste server web | Route e matcher di Caddy |
Quando si migra da un pacchetto Nginx o Apache standard, controllare qualsiasi filtraggio delle richieste che è stato eseguito dal server web prima che PHP-FPM ricevesse la richiesta.
FrankenPHP è basato su Caddy, quindi i metodi e le intestazioni HTTP validi vengono passati attraverso il normale routing di Caddy a meno che il tuo Caddyfile o un altro proxy non li rifiuti prima.
Ad esempio, alcuni server web rifiutano le richieste TRACE per impostazione predefinita.
Se la tua applicazione deve mantenere tale comportamento, aggiungi un matcher esplicito prima di php_server:
example.com {
@trace method TRACE
respond @trace 405
root /var/www/app/public
php_server
}
Applica lo stesso approccio a qualsiasi politica più rigorosa su metodi o intestazioni che il tuo precedente server web imponeva. Lo stesso vale per i nomi delle intestazioni delle richieste: alcuni server web o proxy rifiutano o eliminano nomi di campi HTTP validi ma non comuni prima che PHP-FPM li veda, mentre FrankenPHP potrebbe passarli all’applicazione PHP.
Una tipica configurazione Nginx + PHP-FPM:
# /etc/nginx/sites-available/example.com
server {
listen 80;
server_name example.com;
root /var/www/app/public;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
Diventa un singolo Caddyfile:
example.com {
root /var/www/app/public
php_server
}
Questo è tutto. La direttiva php_server gestisce il routing PHP, il comportamento simile a try_files e la gestione dei file statici.
Il tuo php.ini esistente funziona così com’è. Vedi Configurazione per sapere dove posizionarlo a seconda del tuo metodo di installazione.
Un’impostazione cambia significato: max_execution_time conta il tempo reale (“wall time”) in FrankenPHP, mentre le build non-ZTS di PHP-FPM su Linux contano il tempo CPU.
L’attesa di una query di database, una chiamata HTTP, sleep() o il blocco di un file di sessione ora contano ai fini del limite, quindi un valore ottimizzato per PHP-FPM potrebbe essere troppo basso.
Puoi anche impostare le direttive direttamente nel Caddyfile:
{
frankenphp {
php_ini memory_limit 256M
php_ini max_execution_time 30
}
}
example.com {
root /var/www/app/public
php_server
}
In PHP-FPM, si regola pm.max_children per controllare il numero di processi worker.
In FrankenPHP, l’equivalente è num_threads:
{
frankenphp {
num_threads 16
}
}
Per impostazione predefinita, FrankenPHP avvia 2 thread per CPU. Per uno scaling dinamico simile a pm = dynamic di PHP-FPM:
{
frankenphp {
num_threads 4
max_threads auto
}
}
Una tipica configurazione Docker con PHP-FPM che utilizza due container (Nginx + PHP-FPM) può essere sostituita da un singolo container:
Prima:
# compose.yaml
services:
nginx:
image: nginx:1
volumes:
# monta la configurazione Nginx nel container
- ./config:/etc/nginx/conf.d
- .:/var/www/app
ports:
- "80:80"
- "443:443"
php:
image: php:8.5-fpm
volumes:
- .:/var/www/app
Dopo:
# compose.yaml
services:
php:
image: dunglas/frankenphp:1-php8.5
volumes:
- .:/var/www/app
# monta il Caddyfile nel container
- ./config:/etc/frankenphp
- caddy_data:/data
- caddy_config:/config
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
caddy_data:
caddy_config:
Se hai bisogno di estensioni PHP aggiuntive, consulta Creare un’immagine Docker personalizzata.
Per configurazioni Docker specifiche per framework, consulta Symfony Docker e eseguire Laravel con l’immagine Docker di FrankenPHP.
In modalità classica, FrankenPHP funziona come PHP-FPM: ogni richiesta avvia l’applicazione da zero. Questo è un punto di partenza sicuro per la migrazione.
Per prestazioni migliori, puoi passare alla modalità worker, che avvia l’applicazione una volta e la mantiene in memoria:
example.com {
root /var/www/app/public
php_server {
root /var/www/app/public
worker index.php 4
}
}
Caution
La modalità worker mantiene la tua applicazione in memoria tra le richieste. Assicurati che il tuo codice non si basi sullo stato globale che viene resettato tra le richieste. Framework come Symfony, Laravel e API Platform hanno un supporto nativo per questa modalità.
Dopo la migrazione, non avrai più bisogno di:
php-fpm)