php 8.6向浏览器推送私有消息时,可以让mercure hub校验发布者与订阅者jwt的主题权限,并把update的private参数设为true。下面假定已有https hub与应用同域部署,完成一个用户主题的订阅和发布;不把普通eventsource连接本身当作授权。

官方文档:Installation
区分服务地址和主题标识
安装symfony/mercure组件。配置MERCURE_HUB_URL为服务端可访问的Hub端点,浏览器也要能够访问对应的公开端点。主题使用稳定URI,例如https://app.example.com/users/42/events,它是权限匹配标识,不要求浏览器对这个URI另发GET。
composer require symfony/mercure:"^0.10"

官方文档:Subscribing
给订阅者签发最小权限令牌
在已有登录系统中确认用户42身份后,使用Hub约定的签名算法和订阅密钥签发短时JWT。其载荷应含mercure.subscribe数组,仅授权当前用户主题;发布者令牌则使用mercure.publish,不能把带发布权的服务端令牌交给浏览器。
{"sub":"42","exp":1795342200,"mercure":{"subscribe":["https://app.example.com/users/42/events"]}}
exp仅为结构示例,实际签发时用当前时间加短有效期,不能照抄固定时间。PHP用已核验的JWT签发库生成真实签名,不用base64拼接冒充签名。把订阅JWT写入HttpOnly、Secure的mercureAuthorization Cookie;路径覆盖/.well-known/mercure,并按同域部署设置SameSite策略。
签发同源订阅Cookie
以下代码用于已经登录的用户42,前提是Hub配置了HS256订阅签名密钥。密钥从服务端环境读取,Cookie只授权固定主题;其他签名算法不能套用这段签名代码。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
<?php session_start();
if (($_SESSION['user_id'] ?? null) !== 42) { http_response_code(403); exit; }
$secret = getenv('MERCURE_SUBSCRIBER_KEY');
if (!is_string($secret) || strlen($secret)<32) throw new RuntimeException('Missing key');
$encode = static fn(string $s): string => rtrim(strtr(base64_encode($s), '+/', '-_'), '=');
$header = $encode(json_encode(['alg'=>'HS256','typ'=>'JWT'], JSON_THROW_ON_ERROR));
$payload = $encode(json_encode(['sub'=>'42','exp'=>time()+300,
'mercure'=>['subscribe'=>['https://app.example.com/users/42/events']]], JSON_THROW_ON_ERROR));
$unsigned = $header.'.'.$payload;
$jwt = $unsigned.'.'.$encode(hash_hmac('sha256', $unsigned, $secret, true));
setcookie('mercureAuthorization', $jwt, ['expires'=>time()+300,
'path'=>'/.well-known/mercure','secure'=>true,'httponly'=>true,'samesite'=>'Lax']);
echo 'Subscription authorization issued';
连接浏览器并发送私有更新
页面代码只传主题,不把令牌写进查询参数。若分子域部署,必须按Hub文档配置凭据CORS与精确Origin,不能把允许凭据与任意来源组合。
const url = new URL('/.well-known/mercure', location.origin);
url.searchParams.append('topic', 'https://app.example.com/users/42/events');
const events = new EventSource(url, {withCredentials: true});
events.onmessage = event => {
const value = JSON.parse(event.data);
document.querySelector('#status').textContent = value.status;
};
服务端从环境变量读取已签名且未过期的发布JWT,执行下列发布代码。
<?php require __DIR__.'/vendor/autoload.php';
use Symfony\Component\Mercure\Hub;
use Symfony\Component\Mercure\Jwt\StaticTokenProvider;
use Symfony\Component\Mercure\Update;
$hub = new Hub(getenv('MERCURE_HUB_URL'),
new StaticTokenProvider(getenv('MERCURE_PUBLISH_JWT')));
$id = $hub->publish(new Update(
'https://app.example.com/users/42/events',
json_encode(['status'=>'ready'], JSON_THROW_ON_ERROR), true
));
echo $id, PHP_EOL;
验证授权边界而非只看连接成功
有匹配subscribe权限的用户42应收到更新;另一用户的令牌即使能连接Hub,也不应收到这个私有主题。发布返回401先核对publish主题、签名和有效期;浏览器收不到时再核对Cookie域、路径、CORS和主题是否完全一致。连接自动重试不等于业务恰好执行一次,事件ID与业务去重仍由应用处理。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










