Docker环境下PHP调用XSLTProcessor类报错：类未找到

这个错误的核心原因是你的Docker PHP镜像中没有安装XSL扩展，仅修改php.ini启用扩展无效——因为扩展文件本身不存在。以下是针对不同PHP镜像的解决步骤：

1. 自定义Dockerfile构建镜像（推荐） #

如果是通过Dockerfile构建镜像，添加以下命令安装XSL扩展：

针对Debian/Ubuntu基础的PHP镜像（如php:8.2-apache、php:7.4-fpm） #

# 安装依赖并编译XSL扩展
RUN apt-get update && apt-get install -y --no-install-recommends libxslt1-dev \
    && docker-php-ext-install xsl \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

针对Alpine基础的PHP镜像（如php:8.2-apache-alpine） #

Alpine系统的包名不同，使用以下命令：

RUN apk add --no-cache libxslt-dev \
    && docker-php-ext-install xsl

添加完成后重新构建镜像并启动容器即可。

2. 已运行的容器中临时安装扩展 #

如果不想重新构建镜像，可以直接进入运行中的容器安装：

Debian/Ubuntu系容器 #

# 进入容器
docker exec -it <你的容器名称或ID> bash

# 安装依赖和扩展
apt-get update && apt-get install -y libxslt1-dev
docker-php-ext-install xsl

# 退出容器后重启
docker restart <你的容器名称或ID>

Alpine系容器 #

# 进入容器
docker exec -it <你的容器名称或ID> sh

# 安装依赖和扩展
apk add --no-cache libxslt-dev
docker-php-ext-install xsl

# 重启容器
docker restart <你的容器名称或ID>

3. 验证扩展是否安装成功 #

进入容器执行以下命令，若输出xsl则表示安装成功：

php -m | grep xsl

也可以在PHP项目中创建phpinfo.php文件，访问后搜索xsl确认模块已加载。

额外提示 #

• 官方PHP镜像提供的docker-php-ext-install工具会自动处理扩展的配置（包括修改php.ini），无需手动添加extension=xsl.so。
• 若你是手动挂载了自定义php.ini，确保没有注释或删除扩展启用的配置，但前提是扩展已安装。

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