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).
Per impostazione predefinita, FrankenPHP cerca di offrire un buon compromesso tra prestazioni e facilità d’uso. Tuttavia, è possibile migliorare sostanzialmente le prestazioni utilizzando una configurazione appropriata.
Per impostazione predefinita, FrankenPHP avvia un numero di thread e worker due volte superiore (in modalità worker) rispetto al numero disponibile di core della CPU.
I valori appropriati dipendono fortemente da come è scritta l’applicazione, da cosa fa e dall’hardware.
Consigliamo vivamente di modificare questi valori. Per la migliore stabilità del sistema, si consiglia di avere num_threads x memory_limit < available_memory.
Per trovare i valori corretti, è meglio eseguire test di carico simulando il traffico reale. k6 e Gatling sono ottimi strumenti per questo.
Per configurare il numero di thread, utilizzare l’opzione num_threads delle direttive php_server e php.
Per modificare il numero di worker, utilizzare l’opzione num della sezione worker della direttiva frankenphp.
max_threadsSebbene sia sempre meglio sapere esattamente come sarà il traffico, le applicazioni nella vita reale tendono ad essere più
imprevedibili. La configurazione max_threads consente a FrankenPHP di generare automaticamente thread aggiuntivi in fase di esecuzione fino al limite specificato.
max_threads può aiutare a capire quanti thread sono necessari per gestire il traffico e può rendere il server più resistente ai picchi di latenza.
Se impostato su auto, il limite verrà stimato in base a memory_limit in php.ini. Se non è in grado di farlo,
auto verrà invece impostato per impostazione predefinita sul doppio di num_threads. Si tenga presente che auto potrebbe sottostimare fortemente il numero di thread necessari.
max_threads è simile a pm.max_children di PHP FPM. La differenza principale è che FrankenPHP utilizza i thread invece di
processi e li delega automaticamente tra diversi worker e “modalità classica” in base alle esigenze.
L’abilitazione della modalità worker migliora notevolmente le prestazioni, ma l’app deve essere adattata per essere compatibile con questa modalità: è necessario creare un worker ed essere sicuri che l’app non abbia leak di memoria.
La variante Alpine Linux delle immagini Docker ufficiali e i file binari predefiniti che forniamo utilizzano musl libc.
PHP è noto per essere più lento quando si utilizza questa libreria C alternativa invece della tradizionale libreria GNU, soprattutto se compilato in modalità ZTS (thread-safe), richiesta per FrankenPHP. La differenza può essere significativa in un ambiente con numerosi thread.
Inoltre, alcuni bug si verificano solo quando si utilizza musl.
In ambienti di produzione, consigliamo di utilizzare FrankenPHP collegato a glibc, compilato con un livello di ottimizzazione appropriato.
Ciò può essere ottenuto utilizzando le immagini Debian Docker, utilizzando i pacchetti .deb, .rpm o .apk dei nostri manutentori o compilando FrankenPHP dai sorgenti.
Per contenitori più snelli o più sicuri, si potrebbe prendere in considerazione un’immagine Debian rafforzata anziché Alpine.
FrankenPHP è scritto in Go.
In generale, il runtime Go non richiede alcuna configurazione speciale, ma in determinate circostanze, la configurazione specifica migliora le prestazioni.
Probabilmente si vorrà impostare la variabile di ambiente GODEBUG su cgocheck=0 (l’impostazione predefinita nelle immagini Docker FrankenPHP).
Se si esegue FrankenPHP in contenitori (Docker, Kubernetes, LXC…) e la memoria disponibile per i contenitori è limitata,
impostare la variabile di ambiente GOMEMLIMIT sulla quantità di memoria disponibile.
Per ulteriori dettagli, fare riferimento alle variabili di ambiente runtime Go per ottenere il massimo dal runtime.
file_serverPer impostazione predefinita, la direttiva php_server configura automaticamente un file server su
servire file statici (risorse) archiviati nella cartella principale.
Questa funzionalità è conveniente, ma ha un costo. Per disabilitarlo, utilizzare la seguente configurazione:
php_server {
file_server off
}
try_filesOltre ai file statici e ai file PHP, php_server proverà anche a servire l’indice dell’applicazione
e file di indice della cartella (/path/ -> /path/index.php). Se non si ha bisogno degli indici di cartelle,
si possono disabilitare definendo esplicitamente try_files in questo modo:
php_server {
try_files {path} index.php
root /root/to/your/app # aggiungere esplicitamente la root qui consente una cache migliore
}
Ciò può ridurre significativamente il numero di operazioni sui file non necessarie. Un worker equivalente della configurazione precedente sarebbe:
route {
php_server { # usare "php" invece di "php_server" se non si necessita del file server
root /root/to/your/app
worker /path/to/worker.php {
match * # invia tutte le richieste direttamente al worker
}
}
}
Un approccio alternativo con zero operazioni non necessarie sul file system sarebbe invece quello di utilizzare la direttiva php e dividere
file da PHP per percorso. Questo approccio funziona bene se l’intera applicazione è servita da un unico file di ingresso.
Una configurazione di esempio che serve file statici dietro una cartella /assets potrebbe assomigliare a questa:
# Caddyfile: separa risorse statiche e richieste PHP per evitare ricerche sul filesystem
route {
@assets {
path /assets/*
}
# tutto ciò che è sotto /assets viene gestito dal file server
file_server @assets {
root /root/to/your/app
}
# tutto ciò che non è in /assets viene gestito dal file index o worker PHP
rewrite index.php
php {
root /root/to/your/app # aggiungere esplicitamente la root qui consente una cache migliore
}
}
È possibile utilizzare segnaposto nelle direttive root e env.
Tuttavia, ciò impedisce la memorizzazione nella cache di questi valori e comporta un costo significativo in termini di prestazioni.
Se possibile, evitare i segnaposto in queste direttive.
resolve_root_symlinkPer impostazione predefinita, se la document root è un collegamento simbolico, viene automaticamente risolto da FrankenPHP (questo è necessario affinché PHP funzioni correttamente). Se la document root non è un collegamento simbolico, si può disabilitare questa funzione.
php_server {
resolve_root_symlink false
}
Ciò migliorerà le prestazioni se la direttiva root contiene segnaposto.
Negli altri casi il guadagno sarà trascurabile.
I log sono molto utili, ma, per definizione, richiedono operazioni di I/O e allocazioni di memoria, il che riduce notevolmente le prestazioni. Assicurarsi di impostare il livello di log correttamente, per salvare solo ciò che è necessario.
FrankenPHP utilizza l’interprete PHP ufficiale. Tutte le consuete ottimizzazioni delle prestazioni relative a PHP si applicano a FrankenPHP.
In particolare:
realpath sia sufficientemente grande per le esigenze dell’applicazionePer maggiori dettagli, leggere la documentazione sull’ottimizzazione delle prestazioni di Symfony (la maggior parte dei suggerimenti sono utili anche senza utilizzare Symfony).
È normale che le applicazioni interagiscano con servizi esterni lenti, come un’API che tende a essere inaffidabile in condizioni di carico elevato o che impiega costantemente più di 10 secondi per rispondere. In questi casi, può essere utile dividere il pool di thread per avere pool “lenti” dedicati. Ciò impedisce agli endpoint lenti di consumare tutte le risorse/thread del server e limita la concorrenza delle richieste destinate all’endpoint lento, in modo simile a un pool di connessione.
# Caddyfile: pool di thread FrankenPHP dedicato agli endpoint lenti
example.com {
php_server {
root /app/public # la root dell'applicazione
worker index.php {
match /slow-endpoint/* # tutte le richieste con percorso /slow-endpoint/* sono gestite da questo pool di thread
num 1 # minimo 1 thread per le richieste che corrispondono a /slow-endpoint/*
max_threads 20 # consente fino a 20 thread per le richieste che corrispondono a /slow-endpoint/*, se necessario
}
worker index.php {
match * # tutte le altre richieste sono gestite separatamente
num 1 # minimo 1 thread per le altre richieste, anche se gli endpoint lenti iniziano a bloccarsi
max_threads 20 # consente fino a 20 thread per le altre richieste, se necessario
}
}
}
In genere è consigliabile gestire anche gli endpoint molto lenti in modo asincrono, utilizzando meccanismi pertinenti come le code di messaggi.
Modifica questa pagina