如何通过Dockerfile为PHP 5.3安装mbstring扩展？

我明白你在给老旧的PHP 5.3 Apache Docker镜像添加mbstring扩展时碰壁了——那些你尝试的mbstring、php-mbstring之类的包根本找不到，这其实是因为官方PHP 5.3镜像的扩展安装逻辑和你想的不一样。

问题根源 #

官方的PHP Docker镜像（包括5.3版本）是直接从源码编译构建的，并非使用系统包管理器里的预编译PHP包。所以你去找php-mbstring这类系统包自然会找不到，因为它们和镜像里的PHP版本不匹配，甚至源里已经移除了这些老旧包。

正确的解决方法 #

官方镜像提供了专门的工具脚本docker-php-ext-install，用来编译安装PHP的核心扩展，mbstring就属于这类核心扩展。你只需要在Dockerfile里添加一行安装命令即可。

修改后的完整Dockerfile如下：

FROM php:5.3-apache
RUN apt-key adv --keyserver hkp://pool.sks-keyservers.net:80 --recv-keys AA8E81B4331F7F50 \
&& apt-key adv --keyserver hkp://pool.sks-keyservers.net:80 --recv-keys 7638D0442B90D010 \
&& apt-key adv --keyserver hkp://pool.sks-keyservers.net:80 --recv-keys 9D6D8F6BC857C906
RUN apt-get update && \
apt-get install -y \
libfreetype6-dev \
libjpeg62-turbo-dev \
libmcrypt-dev \
libpng-dev \
&& rm -rf /var/lib/apt/lists/* # 清理APT缓存，减小镜像体积
COPY php.ini /usr/local/etc/php/
# 编译安装mbstring扩展
RUN docker-php-ext-install mbstring
RUN a2enmod rewrite

额外说明 #

• docker-php-ext-install是官方镜像内置的脚本，会自动处理扩展编译的依赖和配置，不需要你手动指定源码路径或编译参数。
• 我在apt-get install的末尾加了rm -rf /var/lib/apt/lists/*，这是Docker镜像构建的最佳实践，可以删除临时的APT缓存文件，避免镜像体积过大。
• 如果安装过程中提示缺少特定依赖，你可以在apt-get install的列表里添加对应的开发库，但PHP 5.3的mbstring一般不需要额外的系统库，它属于PHP核心自带的扩展，编译环境官方镜像已经准备齐全。

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