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 i progetti Symfony, raccomandiamo l’uso di Symfony Docker, un progetto ufficiale gestito dall’autore di FrankenPHP. Fornisce un ambiente completo basato su Docker con FrankenPHP, automatizzando HTTPS, HTTP/2, HTTP/3 e supporto ai worker.
In alternativa, si possono eseguire progetti Symfony con FrankenPHP da una macchina locale:
Aggiungere la configurazione seguente a un file chiamato Caddyfile nella cartella principale del progetto Symfony:
# Caddyfile
# Il dominio del server
localhost
root public/
php_server {
# Opzionale: abilita la modalità worker per prestazioni migliori
worker ./public/index.php
}
Si veda la documentazione sulle prestazioni per altre ottimizzazioni.
Lanciare FrankenPHP dalla cartella principale del progetto Symfony: frankenphp run
A partire da Symfony 7.4, la modalità worker di FrankenPHP è supportata nativamente.
Per versioni precedenti, installare il pacchetto PHP Runtime:
composer require runtime/frankenphp-symfony
Lanciare il server, definendo la variabile d’ambiente APP_RUNTIME per usare il runtime di FrankenPHP in Symfony:
docker run \
-e FRANKENPHP_CONFIG="worker ./public/index.php" \
-e APP_RUNTIME=Runtime\\FrankenPhpSymfony\\Runtime \
-v $PWD:/app \
-p 80:80 -p 443:443 -p 443:443/udp \
dunglas/frankenphp
Per approfondire, si veda la modalità worker.
Igor PHP è un linter statico che analizza progetti Symfony cercando violazioni statiche prima che si verifichino in produzione: servizi senza ResetInterface, proprietà con stato che non vengono reimpostate, variabili mutabili locali, chiamate a exit() o die(), scritture superglobali. Verifica sia il codice dell’applicazione sia i servizi dichiarati in vendor/.
composer require --dev igor-php/igor-php
vendor/bin/igor-php .
È abilitato per impostazione predefinita in Symfony Docker.
Per usare la funzionalità di ricarica a caldo senza Symfony Docker, abilitare Mercure e aggiungere la sotto-direttiva hot_reload alla direttiva php_server in Caddyfile:
localhost
mercure {
anonymous
}
root public/
php_server {
hot_reload
worker ./public/index.php
}
Aggiungere quindi il codice seguente al file templates/base.html.twig:
{# templates/base.html.twig #}
{% if app.request.server.has('FRANKENPHP_HOT_RELOAD') %}
<meta name="frankenphp-hot-reload:url" content="{{ app.request.server.get('FRANKENPHP_HOT_RELOAD') }}">
<script src="https://cdn.jsdelivr.net/npm/idiomorph"></script>
<script src="https://cdn.jsdelivr.net/npm/frankenphp-hot-reload/+esm" type="module"></script>
{% endif %}
Infine, eseguire frankenphp run dalla cartella principale del progetto Symfony.
Il componente AssetMapper può comprimere gli asset con Brotli e Zstandard durante il deploy. FrankenPHP (attraverso file_server di Caddy) può servire direttamente questi file compressi direttamente, evitando la complessità di una compressione al volo.
Compilare e comprimere gli asset:
php bin/console asset-map:compile
Aggiornare Caddyfile per servire gli asset compressi:
# Caddyfile
localhost
root public/
handle /assets/* {
file_server {
precompressed zstd br gzip
}
}
php_server {
worker ./public/index.php
}
La direttiva precompressed dice a Caddy di cercare versioni compresse del file richiesto (come app.css.zst, app.css.br) e li serve direttamente ai client che li supportano.
X-Sendfile)FrankenPHP può servire in modo efficiente grandi file statici dopo l’esecuzione di codice PHP (per controllo di accessi, statistiche, eccetera).
Symfony HttpFoundation supporta nativamente la funzionalità.
Dopo aver configurato Caddyfile, troverà automaticamente il valore corretto dell’header X-Accel-Redirect da aggiungere alla risposta:
use Symfony\Component\HttpFoundation\BinaryFileResponse;
BinaryFileResponse::trustXSendfileTypeHeader();
$response = new BinaryFileResponse(__DIR__.'/../private-files/file.txt');
// ...
Usando la funzionalità di embed di FrankenPHP, si possono distribuire applicazioni Symfony come binari indipendenti.
Seguire questi passi per preparare e impacchettare l’app Symfony:
Preparare l’app:
# Esporta il progetto per eliminare .git/, ecc.
mkdir $TMPDIR/my-prepared-app
git archive HEAD | tar -x -C $TMPDIR/my-prepared-app
cd $TMPDIR/my-prepared-app
# Imposta le variabili d'ambiente corrette
echo APP_ENV=prod > .env.local
echo APP_DEBUG=0 >> .env.local
# Rimuovi i test e gli altri file non necessari per risparmiare spazio
# In alternativa, aggiungi questi file con l'attributo export-ignore nel file .gitattributes
rm -Rf tests/
# Installa le dipendenze
composer install --ignore-platform-reqs --no-dev -a
# Ottimizza .env
composer dump-env prod
Creare un file chiamato static-build.Dockerfile nel repository dell’app:
# static-build.Dockerfile
FROM --platform=linux/amd64 dunglas/frankenphp:static-builder-gnu
# Se si intende eseguire il binario su sistemi musl-libc, usare invece static-builder-musl
# Copiare l'applicazione
WORKDIR /go/src/app/dist/app
COPY . .
# Compila il binario statico
WORKDIR /go/src/app/
RUN EMBED=dist/app/ ./build-static.sh
Caution
Alcuni file
.dockerignoreignorano la cartellavendor/e i file.env. Assicurarsi di modificare o rimuovere il file.dockerignoreprima della compilazione.
Build:
docker build -t static-symfony-app -f static-build.Dockerfile .
Estrarre il file binario:
docker cp $(docker create --name static-symfony-app-tmp static-symfony-app):/go/src/app/dist/frankenphp-linux-x86_64 my-app ; docker rm static-symfony-app-tmp
Avviare il server:
./my-app php-server
Ulteriori informazioni sulle opzioni disponibili e su come creare file binari per altri sistemi operativi si possono trovare nella documentazione sull’embed di applicazioni.
Modifica questa pagina