在Docker的PHP8.1-bookworm环境中配置Memcached遇错如何解决？

原本依赖php:8.1-apache镜像的Dockerfile已稳定运行数月，当镜像切换为基于Debian bookworm版本后，构建时Memcached客户端开始报错。

相关Dockerfile代码片段：

FROM php:8.1-apache

...

RUN apt-get update --fix-missing -q \
    && apt-get install -y curl mcrypt gnupg build-essential software-properties-common wget vim zip unzip libxml2-dev libz-dev libpng-dev libmemcached-dev \
    && pecl install memcached \
    && docker-php-ext-enable memcached \

...

构建时的错误信息：

checking for libmemcached location... configure: error: memcached support requires libmemcached. Use --with-libmemcached-dir=<DIR> to specify the prefix where libmemcached headers and library are located
ERROR: `/tmp/pear/temp/memcached/configure --with-php-config=/usr/local/bin/php-config --with-libmemcached-dir=no --with-zlib-dir=no --with-system-fastlz=no --enable-memcached-igbinary=no --enable-memcached-msgpack=no --enable-memcached-json=no --enable-memcached-protocol=no --enable-memcached-sasl=yes --enable-memcached-session=yes' failed

将镜像固定为旧稳定版php:8.1-apache-bullseye可解决问题，需找到适配bookworm版本的方案以沿用原有库及流程。

Debian Bookworm中libmemcached-dev的包结构或默认路径发生了变化，导致pecl安装脚本无法自动识别依赖位置，以下两种方案可解决问题：

方案一：显式指定libmemcached路径并补充依赖 #

在Bookworm环境下，需额外安装libmemcached-tools，同时在pecl安装时指定libmemcached的系统默认路径：

FROM php:8.1-apache

...

RUN apt-get update --fix-missing -q \
    && apt-get install -y curl mcrypt gnupg build-essential software-properties-common wget vim zip unzip libxml2-dev libz-dev libpng-dev libmemcached-dev libmemcached-tools \
    && pecl install memcached --with-libmemcached-dir=/usr \
    && docker-php-ext-enable memcached \

...

方案二：使用官方docker-php-ext-install脚本替代pecl（推荐） #

官方提供的docker-php-ext-install会自动适配当前系统环境，无需手动指定依赖路径，调整后的代码更简洁且兼容性更强：

FROM php:8.1-apache

...

RUN apt-get update --fix-missing -q \
    && apt-get install -y curl mcrypt gnupg build-essential software-properties-common wget vim zip unzip libxml2-dev libz-dev libpng-dev libmemcached-dev \
    && docker-php-ext-install memcached \

...

补充说明 #

• 方案二更贴合官方PHP镜像的构建逻辑，能减少后续环境变更带来的适配成本
• 如果需要安装特定版本的memcached扩展（比如memcached-3.2.0），则优先选择方案一的路径指定方式

内容的提问来源于stack exchange，提问作者Ing. Luca Stucchi