php-amqplib 是 PHP 中最成熟可靠的 RabbitMQ 客户端库，需显式配置 durable 队列、PERSISTENT 消息、手动 ACK、心跳重连及版本锁定才能保障消息不丢失。
php-amqplib 是当前 PHP 生态中构建 RabbitMQ 传输层最成熟、最可靠的 Composer 库。它不是“原生队列”，但能让你用纯 PHP 实现高可靠的消息收发——关键不在语言是否原生，而在协议层是否可靠、ACK 是否可控、连接是否可恢复。
RabbitMQ 连接必须显式启用持久化与确认机制
默认连接和发布行为极易丢消息：未声明 durable 的队列重启后消失；未设 delivery_mode => 2 的消息不落盘；未手动 ack 的消费者崩溃会导致消息永久丢失。
-
$channel->queue_declare('my_queue', false, true, false, false)—— 第三个参数true表示 durable，必须设 -
new AMQPMessage($body, ['delivery_mode' => AMQPMessage::DELIVERY_MODE_PERSISTENT])—— 否则消息只存内存 - 消费者端必须调用
$channel->basic_ack($msg->getDeliveryTag())，且仅在业务逻辑真正执行完后才调用 - 连接断开时，
AMQPStreamConnection不会自动重连，需自己封装重试逻辑（比如用while (true)+sleep(1)+ 异常捕获）
composer.json 中的版本约束直接影响 ACK 行为兼容性
php-amqplib/php-amqplib 在 v3.x 和 v4.x 之间存在关键差异：v4+ 默认启用 publisher confirms（即服务端回执），而 v3.x 需手动开启；v4+ 的 basic_publish 返回值含义也变了。若项目锁死在 "php-amqplib/php-amqplib": "^3.6"，却按 v4 文档写法调用，会静默失败。
- 生产环境务必固定 minor 版本，例如
"php-amqplib/php-amqplib": "3.6.3"，避免自动升级引入行为变更 - 检查
vendor/php-amqplib/php-amqplib/CHANGELOG.md，重点关注 “Breaking changes” 和 “Publisher confirms” 相关条目 - v4+ 若启用 confirms，需配合
$channel->wait()或异步回调，否则可能阻塞或漏等确认
超时与心跳配置不当会导致连接被 RabbitMQ 主动踢出
RabbitMQ 默认 60 秒无心跳就断连，而 php-amqplib 默认心跳是 0（禁用）。一旦网络抖动或消费者处理慢，连接会在无感知下中断，后续 basic_publish 抛 AMQPConnectionClosedException，但多数人没 catch。
- 初始化连接时必须显式传心跳：
new AMQPStreamConnection('localhost', 5672, 'guest', 'guest', '/', [], 3.0, 60)—— 最后两个参数分别是 timeout 和 heartbeat（单位秒） - heartbeat 值建议设为 30～45，不能 > RabbitMQ 配置的
heartbeat（查rabbitmqctl environment或 config 文件） - 不要依赖默认 timeout（3.0s 太短），高负载下 publish 可能超时，应根据消息体大小和网络情况调到 5～10s
basic_publish，而是让每条消息在进程崩溃、网络闪断、RabbitMQ 重启后仍不丢——这取决于你是否把 durable、delivery_mode、ack、heartbeat、version lock 全部对齐，缺一不可。 
