XAMPP 与 Docker 互斥，需用 Docker 完全替代 XAMPP 并通过自定义 Dockerfile 启用 mysqli、gd、opcache 等模块；官方 PHP 镜像需手动安装系统依赖并编译扩展，且 Windows 扩展如 sqlsrv 不兼容。
不能直接在 XAMPP 里“运行 Docker 容器”——XAMPP 和 Docker 是互斥的运行时环境。你真正需要的是：用 Docker 完全替代 XAMPP，同时精准复现其 PHP 模块（如 mysqli、gd、opcache）。
为什么不能把 Docker “塞进” XAMPP
XAMPP 自带 Apache + PHP + MySQL 的 Windows/macOS 本地集成包，所有服务以宿主进程方式运行；Docker 则依赖容器引擎（如 Docker Desktop）启动隔离的 Linux 容器。两者共享端口（如 80、3306）、文件系统和网络栈，强行共存会导致冲突或静默失败。
常见错误现象：
- 启动 Docker 容器后，XAMPP 控制面板显示 Apache “正在运行”，但浏览器访问
localhost返回空白或 502 - 执行
docker run -p 80:80 php:8.2-apache报错：Bind for 0.0.0.0:80 failed: port is already allocated - 试图用
php -m在 XAMPP 的 PHP 里查模块，却想让 Docker 容器加载同一套php.ini—— 路径、扩展路径、so 文件 ABI 全都不兼容
用官方 PHP 镜像启用指定模块的实操步骤
PHP 官方镜像（php:8.2-apache 等）默认只启用了基础模块。要等效 XAMPP 的常用组合（mysqli、pdo_mysql、gd、mbstring、opcache），必须在容器启动前编译或启用扩展。
立即学习“PHP免费学习笔记（深入）”；
推荐做法：写一个轻量 Dockerfile，基于官方镜像做最小增强：
FROM php:8.2-apache
# 启用常见扩展（注意：gd 需额外安装系统依赖）
RUN apt-get update && apt-get install -y \
libfreetype6-dev \
libjpeg62-turbo-dev \
libpng-dev \
&& docker-php-ext-configure gd \
--with-freetype \
--with-jpeg \
&& docker-php-ext-install -j$(nproc) \
mysqli \
pdo_mysql \
gd \
mbstring \
opcache \
&& rm -rf /var/lib/apt/lists/*
<h1>复制自定义 php.ini（可选，否则用镜像默认配置）</h1><h1>COPY php.ini /usr/local/etc/php/php.ini</h1><p>构建并运行：
- 保存为
Dockerfile，执行docker build -t my-php-app . - 运行：
docker run -d -p 8080:80 -v $(pwd)/htdocs:/var/www/html my-php-app - 访问
http://localhost:8080，确认phpinfo()中列出目标模块状态为 “enabled”
模块启用失败的三个高频原因
不是所有扩展都能靠 docker-php-ext-install 一键成功。以下情况需单独处理：
-
redis或memcached：需先pecl install，再docker-php-ext-enable；例如：pecl install redis && docker-php-ext-enable redis -
imagick：依赖系统级libmagickwand，必须apt-get install libmagickwand-dev再编译，否则报configure: error: not found. Please provide a path to MagickWand-config - Windows 用户用 WSL2 运行 Docker：确保
/etc/resolv.conf未被 WSL 覆盖导致apt-get update超时；可在/etc/wsl.conf中加[network] generateResolvConf = false
如何验证模块是否真可用，而非仅“列在 phpinfo 里”
很多用户卡在“扩展名显示 enabled”，但实际调用时报 Call to undefined function。根本原因是：扩展已加载，但函数未导出（常见于 GD、cURL 编译参数遗漏）。
快速验证法（在容器内执行）：
- 检查扩展是否被 PHP 解析：
docker exec -it <container-id> php -m | grep mysqli</container-id> - 检查函数是否存在：
docker exec -it <container-id> php -r "var_dump(function_exists('mysqli_connect'));"</container-id> - 对 GD 验证：
docker exec -it <container-id> php -r "var_dump(extension_loaded('gd') && function_exists('imagecreate'));"</container-id>
如果返回 bool(false)，说明扩展虽加载，但核心函数缺失——大概率是编译时漏了依赖库或 configure 参数。
模块兼容性比想象中脆弱：XAMPP 的 PHP 是 VC15/VC17 编译、线程安全（TS）版本；Docker 官方镜像是 Unix-style、非线程安全（NTS）构建。这意味着某些 Windows-only 扩展（如 sqlsrv）根本无法在标准 PHP Docker 镜像中启用。
