PHP中获取RabbitMQ队列消息总数需用AMQP_PASSIVE标志被动声明队列，调用$queue->getMessages()得messages_ready数；若需含unacknowledged的总数，则PHP-AMQP扩展不支持，须改用HTTP API或rabbitmqctl工具。
PHP 无法直接获取“实时消息总线数量”——RabbitMQ 里没有叫“消息总线”的实体，你真正想查的是某个队列的 messages_ready（就绪待消费）或 messages（含未确认）总数。关键在用对方式、选对参数、避开被动声明陷阱。
用 AMQP_PASSIVE 声明队列才能安全读数
直接调用 $queue->declare() 默认会创建队列（如果不存在），这可能意外改变服务端状态。必须显式设置 AMQP_PASSIVE 标志，让声明行为变成只读查询：
-
$queue->setFlags(AMQP_PASSIVE)必须在setName()之后、declare()之前调用 - 若队列不存在，
declare()会抛出AMQPChannelException，需try/catch捕获 - 返回值是
AMQPQueue对象，其getMessages()方法不返回准确计数，得靠declare()的返回结构体
declare() 返回值里取哪个字段？
调用 $queue->declare() 后，返回的是一个包含队列元信息的对象（底层是 amqp_table_t 解析结果），但 PHP-AMQP 扩展实际暴露的是方法级接口：
- 正确字段是
$queue->getMessages()—— 它对应的是messages_ready，即就绪可被新消费者拉走的消息数 - 要拿到含未确认（
unacknowledged）的总数，PHP-AMQP 扩展本身不直接提供；得改用 HTTP API 或rabbitmqctl - 别误用
$queue->getConsumers()，那是当前活跃消费者数，和消息量无关
权限和连接配置常被忽略
即使代码写对，也会因权限或配置失败，典型表现是空返回或连接拒绝：
立即学习“PHP免费学习笔记（深入）”；
-
vhost必须显式指定，不能依赖默认值；URL 中的/要 URL 编码成%2F，否则连接失败 - 用户需有
configure+read权限（仅read不够，passive declare需要configure权限） - PHP-AMQP 扩展版本要 ≥ 1.11.0，旧版对
AMQP_PASSIVE支持不稳定，易返回 0 - 不要复用长期存活的
AMQPConnection实例做高频轮询，连接超时或心跳断开后不会自动重连
最易被绕过的点：你以为查的是“当前总消息数”，但 getMessages() 只给 ready；要监控积压风险，必须同时知道 unacknowledged，而这在 PHP-AMQP 里没现成接口——要么切 HTTP API，要么接受用 CLI 工具定期采样。
