Composer安装php-amqplib报错“package not found”主因是包名错误（正确为php-amqplib/php-amqplib）或源未切国内镜像；连接失败多因网络不通、RabbitMQ未启动、guest用户被禁用或vhost权限不足；PHP 8.1+需升级至v3.6+并适配新API。
Composer 安装 php-amqplib 报错“package not found”
不是包名写错了，就是源没切对。php-amqplib 的正确包名是 php-amqplib/php-amqplib，不是 php-amqplib 或 amqplib —— 少写任何一部分都会触发 Package not found。
国内用户常因默认源慢或同步滞后导致安装失败，建议先执行：
composer config -g repo.packagist composer https://packagist.phpcomposer.com
或者用阿里云镜像（更稳定）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 确认当前项目 PHP 版本 ≥ 7.2（
php-amqplibv3.x 要求 PHP ≥ 7.2；v2.x 支持 PHP 5.6+，但已停止维护） - 如果项目用了
composer.lock，改完源后记得删掉它再composer install，否则可能复用旧锁文件里的失效地址 - 不推荐全局安装（
composer global require），容易和项目依赖冲突，一律走项目本地require
require 后无法 use PhpAmqpLibConnectionAMQPStreamConnection
类找不到，90% 是 autoloader 没生效，不是代码写错了。Composer 安装成功后必须确保已加载自动加载器：
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
require_once __DIR__ . '/vendor/autoload.php';
这个语句必须出现在你实例化连接前，且路径要对得上——如果你在 src/ 下写业务代码，vendor/ 应该和 src/ 同级。
- 检查
vendor/autoload.php文件是否存在，不存在说明composer install没跑成功（比如中途被 Ctrl+C 中断） - 运行
composer dump-autoload强制刷新映射，尤其当你手动改过composer.json的autoload字段后 - 别用 IDE 自动补全来判断类是否存在——它可能缓存了旧索引；以
php -r "echo class_exists('PhpAmqpLib\Connection\AMQPStreamConnection') ? 'ok' : 'fail';"实际验证
AMQPStreamConnection 连接 RabbitMQ 失败：stream_socket_client(): unable to connect
这错误不是 php-amqplib 的问题，是网络或服务没起来。先绕过 PHP，用最简命令验证连通性：
telnet localhost 5672
如果连不上，说明 RabbitMQ 没运行、端口被占、或配置了非默认端口（比如启用了 TLS 后改成了 5671）。
-
AMQPStreamConnection默认不启用 TLS，若 RabbitMQ 开了 SSL，得换AMQPSocketConnection并传入证书路径 - 用户名密码默认是
guest/guest，但新版本 RabbitMQ 会禁用远程 guest 登录；需创建专用用户并赋权：rabbitmqctl add_user myuser mypass && rabbitmqctl set_permissions -p / myuser ".*" ".*" ".*" - 连接超时参数容易被忽略：
new AMQPStreamConnection($host, $port, $user, $pass, $vhost, false, 'AMQPLAIN', null, 30)最后一个30是连接超时秒数，内网建议设为 3–5，避免卡死
PHP 8.1+ 使用 php-amqplib 出现 Deprecated 警告
v3.4+ 已适配 PHP 8.1，但如果你装的是老版本（如 v2.12.x），会大量报 Deprecated: Return type of PhpAmqpLibWireAMQPWriter::write() should either be compatible with ...。
解决方式只有一条：升级到最新稳定版。执行：
composer require php-amqplib/php-amqplib:^3.6
- v3.6 是目前兼容 PHP 8.0–8.3 最稳的版本，不要贪新用 dev-main
- 升级后注意
AMQPChannel::basic_consume()的回调签名变了——第 7 个参数从$consumerTag变成$isConditional，老代码会崩，必须按新签名调整 - 如果项目还混着 Laravel，留意
laravel-notification-channels/rabbitmq等封装包是否锁死了低版本php-amqplib，得一起升级或换掉
