Ably PHP SDK 安装失败主因是PHP版本低于7.4或openssl/curl/json扩展未启用；连接失败多因API key错误、realtime_host未配wss协议或DNS问题；订阅无响应因PHP单进程需手动loop()或异步环境；Presence数据需主动enter并监听事件而非仅get()。
Ably PHP SDK 安装失败或 composer require ably/ably-php 报错
常见原因是 PHP 版本低于 7.4 或 OpenSSL 扩展未启用。Ably SDK 要求 ext-openssl、ext-json 和 ext-curl 全部可用，缺一不可。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -v确认版本 ≥ 7.4；用php -m | grep -E 'openssl|curl|json'检查扩展是否加载 - 若用 Docker，确保
Dockerfile中有docker-php-ext-install openssl curl json - 某些共享主机禁用
allow_url_fopen，但 Ably SDK 不依赖它；真正影响的是 cURL 的 SSL CA 证书路径 —— 可通过curl.cainfophp.ini 配置项指定系统级 CA 包（如/etc/ssl/certs/ca-certificates.crt）
初始化 Ably\Realtime\Realtime 时连接超时或认证失败
不是密钥写错了就是环境没配对。Ably 的 REST 和 Realtime 通道共用同一 API key，但 Realtime 连接必须走 wss://（非 https://），且默认不自动 fallback 到 REST。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查 key 格式是否为
xxxxxx:yyyyyy（含冒号），且权限包含presence或publish（根据用途） - 显式传入
rest_host和realtime_host参数避免 DNS 解析问题：$client = new \Ably\Realtime\Realtime([ 'key' => 'your-key-here', 'realtime_host' => 'realtime.ably.io', 'rest_host' => 'rest.ably.io' ]); - 若内网部署或测试用本地代理，需额外配置
proxy选项（SDK 支持 cURL 原生 proxy 设置）
订阅频道后收不到消息，channel.subscribe() 无反应
PHP 是单进程阻塞模型，Realtime 实例启动后不会自动轮询或维持长连接事件循环 —— 它依赖你手动调用 loop() 或集成到 ReactPHP/Swoole 等异步环境。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开发调试时加一句
$client->connection->on('connected', function() { echo "Connected\n"; });确认握手成功 - 最简可行示例必须包含
while ($client->isConnected()) { $client->loop(1000); }（单位毫秒），否则连接建立即退出 - 生产环境别用 while-loop：推荐用
react/event-loop封装，或改用 Ably 的 REST 接口 + Webhook 处理下行（更适合传统 PHP-FPM 架构） - 注意频道名区分大小写，且不能含空格或控制字符；
channel.publish()的 payload 必须是 JSON-serializable（不支持资源、闭包、循环引用）
Presence 成员列表为空或 channel.presence.get() 返回空数组
Presence 数据不是广播出来的，而是服务端按需拉取。成员在线状态依赖客户端主动发送心跳（enter() / update() / leave()），且服务端会 30 秒清理无响应连接。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 调用
$channel->presence->enter(['userId' => 123])后，务必等待present事件触发再查列表，否则可能还没同步完成 -
presence.get()是一次性快照，不监听变更；要实时响应进/出事件，得用$channel->presence->on('enter', ...) - 多个 PHP 进程实例（如 CLI 脚本多开）共享同一 clientId 会导致踢人；建议用唯一标识（如
getmypid().microtime(true)）作为clientId
loop() 示例，在 web 请求中一秒钟就超时了。 
