PHP代码里怎么向FrankenPHP的Mercure发布消息-php教程-PHP中文网

直接用curl向mercure hub的publish端点发post请求即可，无需额外php扩展或sdk；frankenphp自带标准mercure实现，兼容所有http客户端，但需显式启用并正确配置jwt密钥、caddyfile及网络地址。

php代码里怎么向frankenphp的mercure发布消息

直接用 curl 向 Mercure Hub 的 Publish 端点发 POST 请求即可，不需要额外 PHP 扩展或 SDK —— FrankenPHP 自带的 Mercure 是标准实现，兼容所有 HTTP 客户端。

确认 Mercure Hub 是否已启用

FrankenPHP 镜像默认不自动启动 Mercure，必须显式启用。检查你的 Caddyfile 或环境变量：

若用 Docker 启动，确保传入 -e MERCURE_PUBLISHER_JWT_KEY=... 和 -e MERCURE_SUBSCRIBER_JWT_KEY=...（两者可相同，但必须非空）

镜像内置的 Caddyfile 中 Mercure 段落默认被注释，需取消注释并补全配置，例如：

mercure {
  publisher_jwt {your_publisher_jwt} {your_key}
  subscriber_jwt {your_subscriber_jwt} {your_key}
  transports memory
}

未正确配置时，curl -v http://localhost/.well-known/mercure 会返回 404 或 500，而不是 Mercure 的 discovery JSON

`curl_exec` 发布消息的最小可行代码

FrankenPHP 的 Mercure Hub 默认监听 http://127.0.0.1:8080/.well-known/mercure（Caddy 内部地址），PHP 进程内直接调用需注意网络可达性：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 Docker 容器中运行 PHP 时，不能用 localhost —— 要用 http://host.docker.internal:8080（Mac/Windows）或 http://172.17.0.1:8080（Linux），或更稳妥地让 Caddy 反向代理 Mercure 到同一域名下（如 /mercure）
JWT 必须由 MERCURE_PUBLISHER_JWT_KEY 签发，且 payload 至少含 publisher 声明；可用 openssl 快速生成测试 token：
```
echo '{"publisher":"test"}' | openssl dgst -sha256 -hmac "your_key" -binary | openssl enc -base64
```

发布代码示例（无依赖，仅 curl）：

$url = 'http://host.docker.internal:8080/.well-known/mercure';
$token = 'your_base64_encoded_publisher_jwt';
$data = json_encode(['data' => 'hello', 'type' => 'update']);
$headers = [
    'Authorization: Bearer ' . $token,
    'Content-Type: application/json',
    'Accept: text/event-stream'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

用 `file_get_contents` 替代 `curl` 的坑

部分 FrankenPHP 部署（尤其是静态二进制或某些容器环境）禁用了 allow_url_fopen，此时 file_get_contents('http://...') 会直接失败：

检查 ini_get('allow_url_fopen') 返回值，为 '' 或 '0' 即不可用
强行开启风险高（尤其生产环境），不推荐；应改用 curl 或封装成独立 CLI 命令由 exec() 调用
即使 allow_url_fopen 开启，也需确保 stream_context_create 显式设置 http 选项中的 header 和 method，否则 JWT 头无法发送

主题（topic）权限与路由匹配

Mercure 默认只允许发布到以 https:// 或 http:// 开头的主题，且必须与 JWT 中 publish 字段声明的前缀匹配：

JWT 若声明 "publish": ["https://example.com/updates"]，则只能发布到 https://example.com/updates/* 类似路径
开发时建议 JWT 设为 "publish": ["*"]（仅限本地），对应 token 签发时用 {"publish":["*"]}
发布请求 URL 中的 topic 参数必须是完整 URI，例如：http://.../.well-known/mercure?topic=https%3A%2F%2Fexample.com%2Fupdates%2Fuser-123
前端 EventSource 订阅时 topic 必须完全一致，大小写和编码都要对得上