直接运行composer require php-amqplib/php-amqplib即可安装，它是纯PHP实现、兼容PHP 7.4+与RabbitMQ 3.9–4.x的唯一推荐客户端，需显式传入host、port、user、pass、vhost五参数，且必须require vendor/autoload.php才能使用AMQPStreamConnection类。
如何用 Composer 安装 php-amqplib
直接运行 composer require php-amqplib/php-amqplib 即可安装主流 PHP AMQP 客户端。它不依赖系统级 AMQP 库（如 librabbitmq），纯 PHP 实现，兼容 PHP 7.4+ 和 8.x，且支持 TLS 连接。
安装后，Composer 自动注册 autoloader，无需手动 require 入口文件 —— 只要项目已引入 vendor/autoload.php，就能直接使用 PhpAmqpLib\Connection\AMQPStreamConnection 等类。
常见错误现象：Class 'PhpAmqpLib\Connection\AMQPStreamConnection' not found，大概率是漏了 require 'vendor/autoload.php';，或在非 Composer 环境下误以为“安装即可用”。
连接 RabbitMQ 时必须传哪些参数
AMQPStreamConnection 构造函数前四个参数为必需：主机、端口、用户名、密码。虚拟主机（vhost）是第五个参数，默认为 '/'，但若服务端配置了自定义 vhost（如 myapp），必须显式传入，否则会报 ACCESS_REFUSED - Login was refused 或连接后无法声明队列。
示例连接代码：
use PhpAmqpLib\Connection\AMQPStreamConnection; <p>$connection = new AMQPStreamConnection( 'localhost', // host 5672, // port 'guest', // user 'guest', // password '/' // vhost —— 注意这里不是可选的空字符串 );
其他常用参数（通过第 6 个数组传入）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
'heartbeat' => 30：建议设为非零值（如 30），避免 NAT 或负载均衡器断连 -
'keepalive' => true：PHP 7.4+ 下启用 socket keepalive，减少意外中断 -
'context' => ['verify_peer' => false]：仅限测试环境绕过 TLS 证书校验；生产环境务必配好 CA 证书路径
为什么 new Channel() 后不能立刻 publish
AMQP 协议要求先声明交换机（exchange）和队列（queue），再绑定关系，最后才能收发消息。跳过声明直接 $channel->basic_publish() 会导致消息被静默丢弃（无报错），或触发 ChannelException: PRECONDITION_FAILED（如果交换机/队列不存在且未设 passive=true）。
正确顺序：
- 调用
$channel->exchange_declare()确保交换机存在 - 调用
$channel->queue_declare()确保队列存在 - 调用
$channel->queue_bind()将队列绑定到交换机（指定 routing key） - 再执行
basic_publish()或basic_consume()
注意：queue_declare 的 $passive 参数默认为 false，即“不存在就创建”；若设为 true 而队列尚未存在，会直接抛异常。
autoload 加载失败或 class not found 的真实原因
不是 Composer 没装好，而是用了错误的命名空间或类名。常见混淆点：
- 旧文档常写
new AMQPConnection(...)—— 这是已废弃的 2.x 版本写法，新版本必须用AMQPStreamConnection或AMQPLazyConnection - 类名大小写敏感：
phpamqplib是包名，但命名空间是PhpAmqpLib（首字母大写） - 没启用扩展？不需要 ——
php-amqplib纯 PHP，不依赖amqp扩展（那是另一个 C 扩展，互不兼容）
验证是否加载成功，可在 CLI 中运行：php -r "var_dump(class_exists('PhpAmqpLib\Connection\AMQPStreamConnection'));"，返回 bool(true) 才算到位。
最易被忽略的一点：RabbitMQ 默认关闭远程管理插件（rabbitmq_management），但客户端连接本身不依赖它；不过如果你用浏览器访问 http://localhost:15672 看不到界面，别误以为是客户端问题 —— 那只是管理后台没开，不影响 AMQP 协议通信。
