最推荐方式是基于官方php:8.3-apache镜像定制Dockerfile：安装libpng-dev等系统依赖，用docker-php-ext-install启用gd、mysqli、pdo_mysql、zip、opcache，COPY php.ini和代码，设www-data权限，EXPOSE 80；构建后docker run -d -p 8080:80运行即可。
用 Docker 构建 PHP 8 镜像，最推荐的方式是基于官方 php:8.x-apache 或 php:8.x-cli 镜像做定制，避免从头编译，省时且安全。关键在于写好 Dockerfile、合理分层、启用必要扩展，并注意基础镜像选择（如 alpine 轻量但扩展支持有限，debian 更兼容）。
选对基础镜像
根据用途选镜像标签：
-
Web 服务（带 Apache）：用
php:8.3-apache（稳定版建议选8.3或8.2，避免用8.3-rc等预发布版） -
CLI 或 FPM 场景：用
php:8.3-fpm（常配 Nginx 反向代理）或php:8.3-cli（脚本/命令行） -
追求体积小：可选
php:8.3-alpine，但注意某些扩展（如sqlsrv、rdkafka）不支持 Alpine，需改用debian基础
写一个实用的 Dockerfile
以 PHP 8.3 + Apache + 常用扩展为例（保存为项目根目录下的 Dockerfile）：
FROM php:8.3-apache
<h1>安装系统依赖（Debian）</h1><p>RUN apt-get update && \
apt-get install -y \
libpng-dev \
libjpeg-dev \
libfreetype6-dev \
libzip-dev \
unzip \
git \
&& rm -rf /var/lib/apt/lists/*</p><h1>启用 PHP 扩展（部分需先安装 dev 包）</h1><p>RUN docker-php-ext-configure gd --with-jpeg=/usr/include/ --with-freetype=/usr/include/ \
&& docker-php-ext-install -j$(nproc) gd mysqli pdo_mysql zip opcache</p><h1>启用 OPCache（生产环境建议调优）</h1><p>COPY ./php.ini /usr/local/etc/php/conf.d/opcache.ini</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p><h1>复制网站代码</h1><p>COPY ./src/ /var/www/html/</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill8430" title="Learn Docker"><img
src="https://img.php.cn/upload/skill/000/000/081/179204589650959.jpg" alt="Learn Docker" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill8430" title="Learn Docker">Learn Docker</a>
<p>通过 LabEx 容器基础课程和镜像/编排实验学习 Docker。Docker 课程和实验通过 LabEx MCP 获取，返回 labex.io 链接以继续。</p>
</div>
<a href="/xiazai/skill8430" title="Learn Docker" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>设置权限（Apache 用户 www-data）</h1><p>RUN chown -R www-data:www-data /var/www/html</p><h1>暴露端口（Apache 默认 80）</h1><p>EXPOSE 80
注意：docker-php-ext-install 是官方镜像内置脚本，会自动编译并启用扩展；扩展名不带 .so，如写 pdo_mysql.so 会失败。
构建与运行
在 Dockerfile 所在目录执行：
# 构建镜像（打标签便于识别） docker build -t my-php-app:8.3 . <h1>运行容器（映射 8080 → 容器 80）</h1><p>docker run -d -p 8080:80 --name php8-app my-php-app:8.3
访问 http://localhost:8080 即可看到效果。如需挂载代码实时开发，可用 -v $(pwd)/src:/var/www/html 替代 COPY。
验证 PHP 版本和扩展
进入容器检查是否生效：
docker exec -it php8-app php -v docker exec -it php8-app php -m | grep -E "gd|mysqli|opcache"
也可在 /var/www/html 下放一个 info.php 文件：<?php phpinfo(); ?>，通过浏览器访问确认配置。
