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 viene fornito con un hub Mercure integrato! Mercure consente di inviare eventi in tempo reale a tutti i dispositivi connessi: riceveranno immediatamente un evento JavaScript.
È una comoda alternativa ai WebSocket, semplice da usare e supportata nativamente da tutti i browser Web moderni!

Il supporto Mercure è disabilitato per impostazione predefinita.
Ecco un esempio minimo di Caddyfile che abilita sia FrankenPHP sia l’hub Mercure:
# Hostname a cui rispondere
localhost
mercure {
# Il secret usato per firmare i token JWT per i publisher
publisher_jwt !ChangeThisMercureHubJWTSecretKey!
# Se si imposta publisher_jwt, si deve impostare anche subscriber_jwt
subscriber_jwt !ChangeThisMercureHubJWTSecretKey!
# Consente subscriber anonimi (senza JWT)
anonymous
}
root public/
php_server
Tip
L’esempio di
Caddyfilefornito dalle immagini Docker include già una configurazione Mercure commentata con comode variabili d’ambiente per configurarlo.Decommentare la sezione Mercure in
/etc/frankenphp/Caddyfileper abilitarla.
Per impostazione predefinita, l’hub Mercure è disponibile nel percorso /.well-known/mercure del server FrankenPHP.
Per iscriversi agli aggiornamenti, utilizzare la classe JavaScript nativa EventSource:
<!-- public/index.html -->
<!doctype html>
<title>Mercure Example</title>
<script>
const eventSource = new EventSource("/.well-known/mercure?topic=my-topic");
eventSource.onmessage = function (event) {
console.log("New message:", event.data);
};
</script>
mercure_publish()FrankenPHP fornisce una comoda funzione mercure_publish() per pubblicare aggiornamenti sull’hub Mercure integrato:
<?php
// public/publish.php
$updateID = mercure_publish('my-topic', json_encode(['key' => 'value']));
// Scrive nel log di FrankenPHP
error_log("update $updateID published", 4);
La firma completa della funzione è:
/**
* @param string|string[] $topics
*/
function mercure_publish(string|array $topics, string $data = '', bool $private = false, ?string $id = null, ?string $type = null, ?int $retry = null): string {}
file_get_contents()Per inviare un aggiornamento ai subscriber connessi, inviare una richiesta POST autenticata all’hub Mercure con i parametri topic e data:
<?php
// public/publish.php
const JWT = 'eyJhbGciOiJIUzI1NiJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.PXwpfIGng6KObfZlcOXvcnWCJOWTFLtswGI5DZuWSK4';
$updateID = file_get_contents('https://localhost/.well-known/mercure', context: stream_context_create(['http' => [
'method' => 'POST',
'header' => "Content-type: application/x-www-form-urlencoded\r\nAuthorization: Bearer " . JWT,
'content' => http_build_query([
'topic' => 'my-topic',
'data' => json_encode(['key' => 'value']),
]),
]]));
// Scrive nel log di FrankenPHP
error_log("update $updateID published", 4);
La chiave passata come parametro dell’opzione mercure.publisher_jwt in Caddyfile deve essere utilizzata per firmare il token JWT utilizzato nell’header Authorization.
Il JWT deve includere un’attestazione mercure con un’autorizzazione publish per gli argomenti da pubblicare.
Consultare la documentazione Mercure sull’autorizzazione.
Per generare i propri token, si può utilizzare questo link jwt.io, ma per le app di produzione, è consigliabile utilizzare token di breve durata generati dinamicamente utilizzando una libreria JWT attendibile.
In alternativa, si può utilizzare il Componente Symfony Mercure, una libreria PHP autonoma.
Questa libreria gestisce la generazione JWT, la pubblicazione degli aggiornamenti e l’autorizzazione basata su cookie per i subscriber.
Innanzitutto, installare la libreria utilizzando Composer:
composer require symfony/mercure lcobucci/jwt
Si può quindi usare in questo modo:
<?php
// public/publish.php
require __DIR__ . '/../vendor/autoload.php';
const JWT_SECRET = '!ChangeThisMercureHubJWTSecretKey!'; // Deve coincidere con mercure.publisher_jwt nel Caddyfile
// Imposta il provider JWT
$jwFactory = new \Symfony\Component\Mercure\Jwt\LcobucciFactory(JWT_SECRET);
$provider = new \Symfony\Component\Mercure\Jwt\FactoryTokenProvider($jwFactory, publish: ['*']);
$hub = new \Symfony\Component\Mercure\Hub('https://localhost/.well-known/mercure', $provider);
// Serializza l'aggiornamento e lo invio all'hub, che lo girerà ai client
$updateID = $hub->publish(new \Symfony\Component\Mercure\Update('my-topic', json_encode(['key' => 'value'])));
// Scrive nel log di FrankenPHP
error_log("update $updateID published", 4);
Mercure è nativamente supportato anche da:
Modifica questa pagina