RabbitMQ非phpEnv内置服务，须独立安装Erlang与RabbitMQ并启用management插件；phpEnv仅管理PHP版本及amqp扩展（需手动下载匹配DLL、配置php.ini并放置依赖库），连接时应使用127.0.0.1而非localhost，且需确保服务运行、端口开放、权限配置正确。
phpEnv 是 Windows 下的 PHP 多版本环境管理工具，本身不提供、也不内置 RabbitMQ 服务。它只负责切换 PHP 版本、管理 php.ini 和扩展，而 RabbitMQ 是独立运行的消息代理（broker），必须单独安装并启动。
你真正要做的，是两件事：
- 在 Windows 上安装并运行 RabbitMQ 服务；
- 让
phpEnv管理的 PHP 能通过amqp扩展连接它。
RabbitMQ 服务必须独立安装（非 phpEnv 内置）
RabbitMQ 是 Erlang 应用，不能靠 phpEnv 启动或托管。你得手动安装：
- 下载 Erlang 官方 Windows 安装包（注意匹配 RabbitMQ 要求的版本，如 25.x 或 26.x）
- 下载 RabbitMQ Server Windows 安装包（推荐
rabbitmq-server-3.13.x.exe） - 安装时勾选「Add RabbitMQ to PATH」和「Install RabbitMQ as a service」
- 安装完成后，用管理员权限运行命令行执行：
rabbitmq-plugins enable rabbitmq_management
然后重启服务：net stop rabbitmq && net start rabbitmq
- 浏览器打开
<a href="https://www.php.cn/link/9e7a3b6fbfa4f7c2052f776f1b4eab35">https://www.php.cn/link/9e7a3b6fbfa4f7c2052f776f1b4eab35</a>，用默认账号guest/guest登录（首次需确认允许 guest 远程登录，或创建新用户）
⚠️ 常见错误：
Connection refused或AMQPConnection::connect(): unable to connect，基本都是 RabbitMQ 没在运行，或防火墙/端口被占（检查 5672 是否被占用）。立即学习“PHP免费学习笔记（深入）”；
phpEnv 下启用 amqp 扩展（不是 php-amqplib）
phpEnv 支持手动启用 DLL 扩展，但 amqp 扩展不自带，也不能用 Composer 安装 —— 它是 C 编写的 SAPI 扩展，必须匹配 PHP 版本（TS/NTS、x64/x86、PHP 主版本）。
你需要：
- 确认当前
phpEnv使用的 PHP 版本及架构：打开终端，运行php -v && php -i | findstr "Thread Safety Architecture"
输出含NTS+x64？那就找对应 DLL。 - 到 PECL 官网下载预编译 DLL：
<a href="https://www.php.cn/link/d5c4a9269e461042632f0e07414edf9d">https://www.php.cn/link/d5c4a9269e461042632f0e07414edf9d</a>
例如 PHP 8.2 NTS x64 → 下载amqp-2.0.0rc1-php-8.2-nts-vs16-x64.zip - 解压后，把
php_amqp.dll放进phpEnv\php{version}\ext\目录 - 把同包里的
rabbitmq.4.dll（或类似名）放进phpEnv\php{version}\根目录（和php.exe同级） - 编辑该 PHP 版本对应的
php.ini（phpEnv\php{version}\php.ini），添加：extension=php_amqp.dll
- 重启你的 Web 服务器（如 Apache/Nginx）或 CLI 环境，运行
php -m | findstr amqp确认加载成功
⚠️ 容易踩的坑：
- 忘了放
rabbitmq.4.dll→ 报错PHP Startup: Unable to load dynamic library 'php_amqp.dll'- 用了 TS 版 DLL 配 NTS PHP → 启动失败且无明确提示
php.ini改的是错的版本（phpEnv可能有多个 ini 文件，务必确认当前生效的是哪个）
连接代码里别写 localhost:5672 就完事
即使扩展加载成功、RabbitMQ 也在跑，AMQPConnection 默认行为仍可能失败：
- 默认使用
login字段，但新版扩展更认username；旧版（如 PHP 7.3）可能只支持login - 必须显式设置
vhost（默认是/，但 URL 编码后是%2F，容易漏） - 推荐用数组方式传参，并捕获异常：
$conn = new AMQPConnection([
'host' => '127.0.0.1',
'port' => 5672,
'username' => 'guest',
'password' => 'guest',
'vhost' => '/',
'read_timeout' => 3,
'write_timeout' => 3
]);
if (!$conn->connect()) {
throw new Exception('AMQP connect failed: ' . $conn->getLastError());
}⚠️ 注意：Windows 下用
localhost有时会走 IPv6，导致连接超时；换成127.0.0.1更稳。
phpEnv 不解决网络或权限问题，这些得你手动过一遍
RabbitMQ 默认只允许本地 guest 用户从本机登录，但一旦你改过配置、加了 vhost、或换了用户，PHP 侧的连接参数就必须同步更新：
- 创建新用户后，记得赋权：
rabbitmqctl set_permissions -p /myvhost myuser ".<em>" ".</em>" ".*"
- 修改了
advanced.config开启远程 guest 登录？那得确认loopback_users.guest = false - 用 Docker 跑 RabbitMQ？那 PHP 不能连
localhost，得连 docker network 里的服务名（和phpEnv无关，那是另一套环境）
phpEnv 只管 PHP 自身，它不管消息中间件的生命周期、网络策略、权限模型——这些全是 RabbitMQ 的职责范围，也是最容易卡住人的地方。
