使用PHP 8.2+AMQP构建Docker容器时遭遇安装错误

问题根源 #

你遇到的configure: error: librabbitmq not found错误，核心原因是编译PHP AMQP扩展需要librabbitmq的开发库文件（头文件、编译依赖），你之前可能仅安装了运行时的librabbitmq包，或者安装时机不对。而PHP 7环境下无此问题，是因为旧版AMQP扩展对依赖的要求更低，且PHP 7镜像的系统源默认包含了满足要求的依赖组件。

解决方案 #

方法一：通过APT安装官方源的librabbitmq开发包（推荐） #

在Dockerfile的apt install步骤中添加librabbitmq-dev包（这是编译扩展必需的开发版依赖，而非仅运行时的librabbitmq4），调整后的安装扩展部分代码如下：

# Install packages and PHP extensions
RUN apt update \
    && apt install -y git acl openssl openssh-client wget zip vim libssh-dev \
    && apt install -y libpng-dev zlib1g-dev libzip-dev libxml2-dev libicu-dev librabbitmq-dev \
    && docker-php-ext-install intl pdo pdo_mysql zip \
    && pecl install amqp xdebug \
    && docker-php-ext-enable --ini-name 05-opcache.ini opcache amqp xdebug

方法二：源码编译安装最新版rabbitmq-c（适用于官方源版本不满足的情况） #

如果APT源中的librabbitmq版本过低，可手动编译安装最新版rabbitmq-c（即librabbitmq），替换上述apt install librabbitmq-dev的步骤：

# 编译安装最新版rabbitmq-c
RUN apt install -y cmake \
    && git clone https://github.com/rabbitmq/rabbitmq-c.git /tmp/rabbitmq-c \
    && cd /tmp/rabbitmq-c \
    && mkdir build && cd build \
    && cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
    && make && make install \
    && rm -rf /tmp/rabbitmq-c

完成后再执行pecl install amqp即可正常编译。

关键注意事项 #

• 必须先安装依赖包，再执行pecl install amqp，否则编译时会找不到依赖文件。
• 若你之前尝试安装librabbitmq但无效，大概率是只安装了运行时包librabbitmq4，而非包含编译所需头文件和配置的开发包librabbitmq-dev。

内容的提问来源于stack exchange，提问作者GerRubio