phpEnv下安装AMQP扩展必须手动编译：先源码安装rabbitmq-c-0.13.0并创建lib软链，再用对应phpEnv版本的phpize和php-config编译amqp-1.11.0，最后将extension=amqp.so写入该版本专属php.ini并重启生效。
phpEnv 下安装 AMQP 扩展不能直接用 pecl install amqp，因为 phpEnv 是多版本共存环境，编译时必须严格匹配当前激活的 PHP 版本路径和 ABI 类型（NTS/TS），否则加载会失败或报 undefined symbol 错误。
确认当前 phpEnv 激活的 PHP 版本和架构
先明确你正在用的 PHP 实际路径与 ABI 类型，这是后续所有步骤的前提：
- 运行
phpenv version查看当前激活版本（如7.4.33） - 运行
php -i | grep "Thread Safety"，输出disabled表示 NTS，enabled表示 TS - 运行
which php-config，确认路径是否指向 phpEnv 对应版本（如~/.phpenv/versions/7.4.33/bin/php-config） - 别信
php -v显示的路径 —— 它可能被 alias 或 PATH 顺序干扰，一定要用which php-config验证
Linux 下编译 amqp 扩展前必须装 rabbitmq-c
amqp 是 C 扩展，依赖底层 librabbitmq 库。phpEnv 环境下不能靠系统包管理器（如 yum install librabbitmq-devel）混用，必须源码编译并指定安装前缀，否则 configure 会找不到头文件或库：
- 下载匹配的
rabbitmq-c版本（推荐v0.13.0，兼容 PHP 7.2–8.2）：wget https://github.com/alanxz/rabbitmq-c/archive/refs/tags/v0.13.0.tar.gz - 解压后进入目录，创建 build 子目录并 cmake：
mkdir build && cd build<br>cmake -DCMAKE_INSTALL_PREFIX=/usr/local/rabbitmq-c-0.13.0 ..<br>make && sudo make install
- 关键一步：检查
/usr/local/rabbitmq-c-0.13.0/lib64是否存在，若存在且lib为空，执行：sudo ln -s lib64 /usr/local/rabbitmq-c-0.13.0/lib - 验证：
pkg-config --modversion librabbitmq应输出0.13.0
用 phpEnv 的 phpize 编译 amqp 扩展
跳过 PECL 自动安装，手动编译才能精准绑定 phpEnv 当前版本：
立即学习“PHP免费学习笔记（深入）”；
- 下载对应 PHP 版本的 amqp 源码（例如 PHP 7.4 → 选
amqp-1.11.0）：wget https://pecl.php.net/get/amqp-1.11.0.tgz - 解压后进入目录，用 phpEnv 的
phpize初始化：~/.phpenv/versions/7.4.33/bin/phpize - configure 必须显式指定：
./configure --with-php-config=~/.phpenv/versions/7.4.33/bin/php-config --with-librabbitmq-dir=/usr/local/rabbitmq-c-0.13.0 - 编译安装：
make && sudo make install - 在 phpEnv 对应版本的配置目录中启用（不是全局
/etc/php.ini）：echo "extension=amqp.so" >> ~/.phpenv/versions/7.4.33/etc/php.ini
Windows 下 phpEnv 不适用，改用原生 PHP + php_amqp.dll
phpEnv 是 Linux/macOS 工具，Windows 用户请放弃该路径。实际可用方案只有两个：
- 如果你用的是 Windows 原生 PHP（非 WSL），直接下载预编译的
php_amqp.dll和配套rabbitmq.4.dll（注意 PHP 版本、线程安全 NT/TS、位数 x64/x86 三者必须完全一致） - 将
php_amqp.dll放入ext/目录，rabbitmq.4.dll放入 PHP 根目录（与php.exe同级） - 在
php.ini中添加：extension=php_amqp.dll - 重启 Web 服务或 CLI，运行
php -m | grep amqp验证；若报错PHP Startup: Unable to load dynamic library 'php_amqp.dll'，90% 是rabbitmq.4.dll路径不对或版本不匹配
最容易被忽略的一点：phpEnv 下每个 PHP 版本都有独立的 php.ini 和扩展目录，改错配置文件或装到错误版本的 ext/ 下，扩展永远不会生效。务必用 php --ini 确认加载的是哪个配置文件，再检查该文件所在目录的 ext/ 是否真有 amqp.so。
