如何在Laravel 9/FilamentPHP 2.x项目中配置Pusher参数？

我在 Laravel 9、Filament 版本为 ^2.17.17 的项目中配置 Pusher 参数时，查阅相关文档后仍有困惑。

Pusher 控制台提供的参数： #

app_id = "NNNN"
key = "KKKKKKKKK"
secret = "XXXXXXX"
cluster = "eu"

项目初始 .env 内容： #

VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

我修改后的 .env 内容： #

BROADCAST_DRIVER=pusher

VITE_PUSHER_APP_KEY="KKKKKKKKK"  # key parameter from pusher console
VITE_PUSHER_HOST="127.0.0.1" # not sure, looks like it must be ip from /etc/hosts of  my local apache 2 host ?
VITE_PUSHER_PORT="6001" # constant value?
VITE_PUSHER_SCHEME="http" # Now I am on my local apache 2 host
VITE_PUSHER_APP_CLUSTER="eu"   # cluster parameter from pusher console

目前不清楚 Pusher 控制台中的 app_id 和 secret 参数应该配置到哪里？同时对 VITE_PUSHER_HOST、VITE_PUSHER_PORT 的取值也有疑问。

解答： #

1. app_id 和 secret 的配置位置
   这两个参数是给 Laravel 后端使用的，需要在 .env 文件中添加非 VITE_ 前缀的对应变量：

PUSHER_APP_ID=NNNN
PUSHER_APP_SECRET=XXXXXXX

同时建议把前端的 VITE_PUSHER_APP_KEY 改为引用后端变量的形式，保持配置一致性：

VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"

2. VITE_PUSHER_HOST 与 VITE_PUSHER_PORT 的取值说明

• 如果你使用的是官方 Pusher 云服务：不需要手动设置这两个变量，Filament/Echo 会根据你配置的 VITE_PUSHER_APP_CLUSTER 自动匹配对应的集群地址和端口（默认 HTTP 用 80，HTTPS 用 443）。
• 如果你是在本地使用 laravel-echo-server 自建推送服务：才需要设置 VITE_PUSHER_HOST=127.0.0.1 和 VITE_PUSHER_PORT=6001，这种场景下你只是兼容 Pusher 协议，并没有用到官方服务。

3. 最终推荐的 .env 配置（使用官方 Pusher 服务）

BROADCAST_DRIVER=pusher

# 后端用的 Pusher 参数
PUSHER_APP_ID=NNNN
PUSHER_APP_KEY=KKKKKKKKK
PUSHER_APP_SECRET=XXXXXXX
PUSHER_APP_CLUSTER=eu

# 前端用的 Pusher 参数
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_SCHEME="http" # 线上环境改为 https
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

内容的提问来源于stack exchange，提问作者mstdmstd