直接用 composer require php-amqplib/php-amqplib:^3.6 安装，前提是镜像已正确配置（键名 repo.packagist、type=composer、URL 含 HTTPS 与末尾斜杠）；否则失败主因是源未生效或 PHP 版本不匹配（需 ≥7.4，8.1+ 必须 v3.6+），而非包本身问题。
直接用 composer require php-amqplib/php-amqplib:^3.6，前提是镜像已正确配置；否则 90% 的失败不是包的问题，是源没走通或 PHP 版本不匹配。
镜像配置必须写对三要素
国内用户卡在“安装慢”或“package not found”，几乎全是镜像配置写错了。关键不是换没换，而是怎么换：
-
repo.packagist键名不能多写s（repos.packagist无效但不报错） - type 必须显式写成
composer，缺了它 Composer 2.x 会 fallback 到默认源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，少斜杠就是 404
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，不是空、null 或报错。
安装命令必须用 composer require，不是 install 或 update
composer require php-amqplib/php-amqplib:^3.6 是唯一推荐方式，原因很实际：
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 只改当前项目依赖，不触碰其他已锁版本，避免
monolog等包被意外升级 - 指定
^3.6而非固定版本（如"v3.0.0"），因 v3.0.0 缺少 AMQP 1.0 headers 支持，某些管理插件或延迟队列会丢 header - PHP 8.1+ 必须用 v3.6+，v2.x 已停止维护且不兼容
如果提示 Could not parse version constraint，先跑 php -v 确认版本 ≥ 7.4；若为 PHP 8.3，^3.6 仍完全兼容。
装完却找不到 PhpAmqpLib\Connection\AMQPStreamConnection
这不是安装失败，是 autoloader 没加载或路径不对：
- 必须在实例化前执行
require_once __DIR__ . '/vendor/autoload.php';，且vendor/要和该文件同级（比如你在src/下写代码，vendor/就得在项目根目录） - 运行
php -r "echo class_exists('PhpAmqpLib\Connection\AMQPStreamConnection') ? 'ok' : 'fail';"实际验证，别信 IDE 补全 - 如果
vendor/autoload.php不存在，说明composer require执行中途被中断，删掉composer.lock和vendor/重来
连接 RabbitMQ 失败：先绕过 PHP 验证网络
stream_socket_client(): unable to connect 这类错误和 php-amqplib 无关，是底层连不上：
- 先手动跑
telnet localhost 5672，不通就说明 RabbitMQ 没启动、端口被占，或配置了 TLS 后实际监听的是5671 -
AMQPStreamConnection默认不启用 TLS；若 RabbitMQ 开了 SSL，必须换AMQPSocketConnection并传入证书路径 - guest 用户在 RabbitMQ 3.3+ 默认被禁用，需创建新用户并赋予
/vhost 权限，不能只靠guest/guest
真正容易被忽略的点：换镜像后，composer.lock 和 vendor/ 必须一起删干净再重装——旧 lock 文件里的哈希和新镜像元数据不兼容，留着只会反复报 hash 不匹配。
