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 include una funzionalità di ricarica a caldo integrata, progettata per migliorare notevolmente l’esperienza degli sviluppatori.

Questa funzionalità fornisce un flusso di lavoro simile alla Sostituzione calda del modulo (HMR) nei moderni strumenti JavaScript come Vite o webpack. Invece di aggiornare manualmente il browser dopo ogni modifica di file (codice PHP, modelli, file JavaScript e CSS…), FrankenPHP aggiorna il contenuto della pagina in tempo reale.
Funziona nativamente con WordPress, Laravel, Symfony e qualsiasi altra applicazione o framework PHP.
Quando abilitato, FrankenPHP controlla la cartella di lavoro corrente per eventuali modifiche al filesystem. Quando un file viene modificato, invia un aggiornamento Mercure al browser.
A seconda della configurazione, il browser:
Per abilitare il ricaricamento a caldo, abilitare Mercure, quindi aggiungere la sottodirettiva hot_reload alla direttiva php_server nel Caddyfile.
Warning
Questa funzionalità è destinata esclusivamente agli ambienti di sviluppo. Non abilitare
hot_reloadin produzione, poiché questa funzionalità non è sicura (espone dettagli interni sensibili) e rallenta l’applicazione.
localhost
mercure {
anonymous
}
root public/
php_server {
hot_reload
}
Per impostazione predefinita, FrankenPHP controllerà tutti i file nella cartella di lavoro corrente che corrispondono a questo modello glob: ./**/*.{css,env,gif,htm,html,jpg,jpeg,js,mjs,php,png,svg,twig,webp,xml,yaml,yml}
È possibile impostare i file da monitorare utilizzando esplicitamente la sintassi glob:
localhost
mercure {
anonymous
}
root public/
php_server {
hot_reload src/**/*{.php,.js} config/**/*.yaml
}
Utilizza la forma lunga hot_reload per specificare l’argomento Mercure da utilizzare, nonché quali cartelle o file controllare:
localhost
mercure {
anonymous
}
root public/
php_server {
hot_reload {
topic hot-reload-topic
watch src/**/*.php
watch assets/**/*.{ts,json}
watch templates/
watch public/css/
}
}
Mentre il server rileva le modifiche, il browser deve iscriversi a questi eventi per aggiornare la pagina.
FrankenPHP espone l’URL Mercure Hub da utilizzare per sottoscrivere le modifiche ai file tramite la variabile di ambiente $_SERVER['FRANKENPHP_HOT_RELOAD'].
È inoltre disponibile una comoda libreria JavaScript, frankenphp-hot-reload, per gestire la logica lato client. Per usarlo, aggiungere quanto segue al layout principale:
<!DOCTYPE html>
<title>FrankenPHP Hot Reload</title>
<?php if (isset($_SERVER['FRANKENPHP_HOT_RELOAD'])): ?>
<meta name="frankenphp-hot-reload:url" content="<?=$_SERVER['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>
<?php endif ?>
La libreria si iscriverà automaticamente all’hub Mercure, recupererà l’URL corrente in background quando viene rilevata una modifica al file e trasformerà il DOM. È disponibile come pacchetto npm e su GitHub.
In alternativa, si può implementare una logica lato client iscrivendosi direttamente all’hub Mercure, usando la classe JavaScript nativa EventSource.
In rari casi, come quando si utilizzano strumenti di sviluppo come la barra degli strumenti di debug web di Symfony,
potresti voler preservare specifici nodi DOM.
Per farlo, aggiungere l’attributo data-frankenphp-hot-reload-preserve all’elemento HTML pertinente:
<div data-frankenphp-hot-reload-preserve><!-- My debug bar --></div>
Se si esegue l’applicazione in modalità worker, lo script dell’applicazione rimane in memoria. Ciò significa che le modifiche al codice PHP non verranno applicate immediatamente, anche se il browser si ricarica.
Per offrire la migliore esperienza agli sviluppatori, si consiglia di combinare hot_reload con la sottodirettiva watch nella direttiva worker.
hot_reload: aggiorna il browser quando i file cambianoworker.watch: riavvia il worker quando i file cambiano# Caddyfile: combina hot reload di FrankenPHP con watch del worker per un flusso di sviluppo completo
localhost
mercure {
anonymous
}
root public/
php_server {
hot_reload
worker {
file /path/to/my_worker.php
watch
}
}
e-dant/watcher dietro le quinte (abbiamo contribuito al binding Go).watch è abilitato nella configurazione del worker, il worker PHP viene riavviato per caricare il nuovo codice.window.location.reload() per aggiornare la pagina.