最推荐方式是基于官方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><h1>复制网站代码</h1><p>COPY ./src/ /var/www/html/</p><h1>设置权限(Apache 用户 www-data)</h1><p>RUN chown -R www-data:www-data /var/www/html</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" 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 rel="nofollow" href="/xiazai/skill8430" title="Learn Docker" class="overflowclass">Learn Docker</a> <p class="overflowclass">通过 LabEx 容器基础课程和镜像/编排实验学习 Docker。Docker 课程和实验通过 LabEx MCP 获取,返回 labex.io 链接以继续。</p> </div> <a rel="nofollow" href="/xiazai/skill8430" title="Learn Docker" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div><h1>暴露端口(Apache 默认 80)</h1><p>EXPOSE 80 </p>
注意: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 </p>
访问 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(); ?>,通过浏览器访问确认配置。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










