Dockerfile是PHP网站实现跨环境一致运行的核心手段，包含五种标准化方案：一、PHP-FPM轻量后端；二、PHP-Apache一体化部署；三、多阶段构建优化体积与安全；四、Xdebug开发调试专用；五、生产就绪型强化安全与性能。
如果您正在为PHP网站构建可复现、跨环境一致的运行环境，则Dockerfile是实现开发与生产环境标准化的核心手段。以下是多种基于Dockerfile的标准化构建方案：
一、使用官方PHP-FPM镜像构建轻量后端服务
该方法适用于Nginx+PHP-FPM分离架构，通过精简基础镜像、按需安装扩展，确保镜像体积小、启动快、依赖明确。
1、在项目根目录创建名为 Dockerfile.php 的文件。
2、写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
FROM php:8.2-fpm-alpine
RUN apk add --no-cache libzip-dev zip unzip && docker-php-ext-install pdo_mysql mysqli opcache zip
COPY ./src /var/www/html
WORKDIR /var/www/html
RUN chown -R www-data:www-data /var/www/html && chmod -R 755 /var/www/html
EXPOSE 9000
USER www-data
二、基于PHP-Apache镜像的一体化快速部署方案
该方案将Web服务器与PHP运行时集成于单个容器，适合小型项目或快速验证场景，无需额外配置反向代理，开箱即用。
1、新建 Dockerfile.apache 文件。
2、写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
FROM php:8.2-apache
RUN docker-php-ext-install mysqli pdo pdo_mysql opcache
COPY ./src /var/www/html
RUN a2enmod rewrite && echo "ServerName localhost" >> /etc/apache2/apache2.conf
EXPOSE 80
ENV APACHE_DOCUMENT_ROOT /var/www/html
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf
三、多阶段构建优化镜像体积与安全性
该方法分离构建与运行阶段，避免将编译工具、源码、调试依赖带入生产镜像，显著减小最终镜像尺寸并提升安全基线。
1、创建 Dockerfile.multi-stage 文件。
2、写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
FROM php:8.2-cli-alpine AS builder
RUN apk add --no-cache composer git
WORKDIR /app
COPY ./composer.json ./composer.lock ./
RUN composer install --no-dev --optimize-autoloader --no-interaction
COPY . .
FROM php:8.2-fpm-alpine
RUN docker-php-ext-install pdo_mysql opcache
COPY --from=builder /app /var/www/html
WORKDIR /var/www/html
EXPOSE 9000
USER www-data
四、支持Xdebug调试的开发专用Dockerfile
该方案专为本地开发设计，在运行时启用Xdebug扩展，并开放远程调试端口，便于IDE（如PHPStorm、VS Code）进行断点调试。
1、创建 Dockerfile.dev 文件。
2、写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
FROM php:8.2-fpm
RUN pecl install xdebug-3.3.1 && docker-php-ext-enable xdebug
RUN echo "xdebug.mode=debug" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.client_host=host.docker.internal" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.client_port=9003" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.start_with_request=yes" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
COPY ./src /var/www/html
EXPOSE 9000 9003
USER www-data
五、生产就绪型Dockerfile：禁用危险函数与强化权限控制
该方案面向生产环境，通过禁用高风险PHP函数、限制容器用户权限、关闭错误显示、启用OPcache预加载等措施，提升安全性与性能。
1、创建 Dockerfile.prod 文件。
2、写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
FROM php:8.2-fpm-alpine
RUN docker-php-ext-install pdo_mysql opcache && apk del .build-deps
COPY ./src /var/www/html
COPY ./php.ini /usr/local/etc/php/conf.d/custom.ini
WORKDIR /var/www/html
RUN chown -R www-data:www-data /var/www/html && chmod -R 755 /var/www/html
USER www-data
EXPOSE 9000
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD curl -f http://localhost:9000/health.php || exit 1
