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).
Le seguenti estensioni non sono compatibili con FrankenPHP:
| Nome | Motivo | Alternative |
|---|---|---|
| imap | Non thread-safe | javanile/php-imap2, webklex/php-imap, ImapEngine |
| newrelic | Non thread-safe | - |
| pcov | Non thread-safe (SIGSEGV in modalità classica) | Raccogliere la copertura con la SAPI CLI (eseguire PHPUnit/Pest al di fuori di FrankenPHP) |
Le seguenti estensioni presentano bug noti e comportamenti imprevisti se utilizzate con FrankenPHP:
| Nome | Problema |
|---|---|
| datadog | Sperimenta instabilità durante la profilazione di FrankenPHP. Questo bug è monitorato da DataDog. |
| blackfire | Il supporto FrankenPHP è in beta e non ancora completo di funzionalità. |
| imagick | I thread OpenMP di ImageMagick sono in conflitto con i thread di FrankenPHP, causando instabilità e crash. Mitigare disabilitando il threading di ImageMagick tramite \Imagick::setResourceLimit(\Imagick::RESOURCETYPE_THREAD, 1) o compilando ImageMagick con --disable-openmp. OpenMP è già disabilitato nei binari statici e nei pacchetti ufficiali apt/apk/rpm, quindi sono interessate solo le immagini Docker e le installazioni Homebrew. |
A partire da PHP 8.2.35, 8.3.36, 8.4.27 e 8.5.12, il superamento di memory_limit non arresta più lo script immediatamente: l’errore fatale “Allowed memory size exhausted” viene sollevato alla successiva chiamata di funzione o iterazione del ciclo.
Se lo script alloca oltre il limite di memoria rigido prima di ciò, PHP esce dal processo.
Il limite rigido predefinito è il doppio di memory_limit (o memory_limit più 1 GiB al di sopra di 1 GiB) e può essere modificato con l’impostazione INI memory_hard_limit_percent.
Il codice che continua a essere eseguito oltre memory_limit può raggiungerlo, ad esempio una singola allocazione maggiore di memory_limit (come array_merge() su array di grandi dimensioni) o concatenazioni di stringhe consecutive.
PHP-FPM perde solo un processo figlio.
FrankenPHP serve tutte le richieste da thread di un singolo processo, quindi ogni richiesta in corso viene persa e il server si ferma fino al riavvio.
Eseguire FrankenPHP sotto un supervisore che lo riavvia, come una policy di riavvio di Docker o Restart= di systemd (già impostato nei pacchetti deb e rpm).
La funzione get_browser() sembra funzionare male dopo un po’. Una soluzione alternativa consiste nel memorizzare nella cache (ad esempio con APCu) i risultati per agente utente, poiché sono statici.
Le immagini Docker binarie completamente statiche e basate su Alpine (dunglas/frankenphp:*-alpine) utilizzano musl libc invece di glibc e amici, per mantenere una dimensione binaria più piccola.
Ciò potrebbe portare ad alcuni problemi di compatibilità.
In particolare, il flag glob GLOB_BRACE non è disponibile.
Preferire l’utilizzo della variante GNU del binario statico e delle immagini Docker basate su Debian se si riscontrano problemi.
https://127.0.0.1 con DockerPer impostazione predefinita, FrankenPHP genera un certificato TLS per localhost.
È l’opzione più semplice e consigliata per lo sviluppo locale.
Se invece si vuole utilizzare 127.0.0.1 come host, è possibile configurarlo per generare un certificato impostando il nome del server su 127.0.0.1.
Sfortunatamente, questo non è sufficiente quando si utilizza Docker, a causa del suo sistema di rete.
Si riceverà un errore TLS simile a curl: (35) LibreSSL/3.3.6: error:1404B438:SSL routines:ST_CONNECT:tlsv1 alert internal error.
Se si usa Linux, una soluzione è utilizzare il driver di rete host:
docker run \
-e SERVER_NAME="127.0.0.1" \
-v $PWD:/app/public \
--network host \
dunglas/frankenphp
Il driver di rete host non è supportato su Mac e Windows. Su queste piattaforme si dovrà ricavare l’indirizzo IP del contenitore e includerlo nei nomi dei server.
Eseguire docker network inspect bridge e cercare la chiave Containers per identificare l’ultimo indirizzo IP attualmente assegnato sotto la chiave IPv4Address e incrementarlo di uno. Se non è in esecuzione alcun contenitore, il primo indirizzo IP assegnato è solitamente 172.17.0.2.
Quindi, includerlo nella variabile di ambiente SERVER_NAME:
docker run \
-e SERVER_NAME="127.0.0.1, 172.17.0.3" \
-v $PWD:/app/public \
-p 80:80 -p 443:443 -p 443:443/udp \
dunglas/frankenphp
Caution
Assicurarsi di sostituire
172.17.0.3con l’IP che verrà assegnato al contenitore.
Ora dovrebbe essere possibile accedere a https://127.0.0.1 dal computer host.
In caso contrario, avviare FrankenPHP in modalità debug per cercare di capire il problema:
docker run \
-e CADDY_GLOBAL_OPTIONS="debug" \
-e SERVER_NAME="127.0.0.1" \
-v $PWD:/app/public \
-p 80:80 -p 443:443 -p 443:443/udp \
dunglas/frankenphp
@phpGli script di Composer potrebbero voler eseguire un binario PHP per alcune attività, ad es. in un progetto Laravel per eseguire @php artisan package:discover --ansi. Questo attualmente fallisce per due motivi:
-d nel comando, che FrankenPHP non supporta ancora.Come soluzione alternativa, possiamo creare uno script di shell in /usr/local/bin/php che rimuove i parametri non supportati e quindi chiama FrankenPHP:
#!/usr/bin/env bash
# /usr/local/bin/php
args=("$@")
index=0
for i in "$@"
do
if [ "$i" == "-d" ]; then
unset 'args[$index]'
unset 'args[$index+1]'
fi
index=$((index+1))
done
/usr/local/bin/frankenphp php-cli ${args[@]}
Quindi impostare la variabile di ambiente PHP_BINARY sul percorso dello script php ed eseguire Composer:
export PHP_BINARY=/usr/local/bin/php
composer install
Quando si utilizzano i binari statici, è possibile che si verifichino i seguenti errori relativi a TLS, ad esempio quando si inviano email utilizzando STARTTLS:
Unable to connect with STARTTLS: stream_socket_enable_crypto(): SSL operation failed with code 5. OpenSSL Error messages:
error:80000002:system library::No such file or directory
error:80000002:system library::No such file or directory
error:80000002:system library::No such file or directory
error:0A000086:SSL routines::certificate verify failed
Poiché il binario statico non include i certificati TLS, è necessario indirizzare OpenSSL all’installazione dei certificati CA locali.
Esaminare l’output di openssl_get_cert_locations(),
per trovare dove devono essere installati i certificati CA e archiviarli in questa posizione.
Warning
I contesti Web e CLI possono avere impostazioni diverse. Assicurarsi di eseguire
openssl_get_cert_locations()nel contesto corretto.
I certificati CA estratti da Mozilla possono essere scaricati sul sito cURL.
In alternativa, molte distribuzioni, tra cui Debian, Ubuntu e Alpine, forniscono pacchetti denominati ca-certificates che contengono questi certificati.
È anche possibile utilizzare SSL_CERT_FILE e SSL_CERT_DIR per suggerire a OpenSSL dove cercare i certificati CA:
# Imposta le variabili d'ambiente dei certificati TLS
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
export SSL_CERT_DIR=/etc/ssl/certs