Docker容器中PHP 8.1安装php-zmq扩展失败，求解决方案

• 缺少编译依赖：安装zmq-beta需要编译环境（如gcc、make、pkg-config）以及ZeroMQ的开发库libzmq-dev，仅安装运行时库libzmq5无法满足编译需求，会导致pecl安装失败。
• 未清理APT缓存：apt-get update和install后未清理/var/lib/apt/lists/*，会增大镜像体积。
• 版本兼容性风险：zmq-beta是测试版本，可能未完全适配PHP 8.1，存在兼容性问题导致安装失败或运行异常。

方案1：修复原Dockerfile，补充依赖并优化 #

FROM php:8.1-apache

# 安装编译依赖+运行时依赖，同时清理缓存
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    make \
    pkg-config \
    libzmq-dev \
    libzmq5 \
    && rm -rf /var/lib/apt/lists/*

# 安装适配PHP8.1的zmq稳定版本
RUN pecl install zmq-1.1.3 \
    && docker-php-ext-enable zmq

注：zmq-1.1.3是已适配PHP8.1的稳定版本，可直接从pecl源安装。

方案2：源码编译扩展 #

FROM php:8.1-apache

RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    make \
    pkg-config \
    libzmq-dev \
    libzmq5 \
    git \
    && rm -rf /var/lib/apt/lists/*

# 拉取适配PHP8的源码分支编译安装
RUN git clone --branch php8 https://github.com/mkoppanen/php-zmq.git /tmp/php-zmq \
    && cd /tmp/php-zmq \
    && phpize \
    && ./configure \
    && make && make install \
    && docker-php-ext-enable zmq \
    && rm -rf /tmp/php-zmq

方案3：非Docker环境用第三方预编译包 #

针对Debian/Ubuntu系统，可通过第三方源获取预编译包：

apt-get update && apt-get install -y software-properties-common
add-apt-repository ppa:ondrej/php
apt-get update
apt-get install -y php8.1-zmq

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