PHP框架容器化部署需五步：一、构建Docker镜像；二、多阶段构建优化体积；三、docker-compose统一管理依赖；四、改用Alpine镜像减小体积；五、挂载配置实现环境差异化。
如果您希望将PHP框架部署到生产环境，但缺乏一致的运行环境，则可能是由于本地开发与服务器环境存在差异。以下是将PHP框架容器化部署的具体步骤：
一、构建自定义Docker镜像
通过编写Dockerfile定义PHP运行时、扩展依赖及框架代码的集成方式，确保每次构建生成完全一致的镜像。
1、在项目根目录创建名为Dockerfile的文件。
2、写入基础镜像指令：FROM php:8.2-apache。
立即学习“PHP免费学习笔记（深入）”；
3、安装必要扩展：RUN docker-php-ext-install pdo_mysql mbstring opcache。
4、启用Apache重写模块：RUN a2enmod rewrite。
5、复制项目代码到Web根目录：COPY . /var/www/html/。
6、设置权限并暴露端口：RUN chown -R www-data:www-data /var/www/html/ && EXPOSE 80。
二、使用多阶段构建优化镜像体积
分离构建依赖与运行时依赖，避免将编译工具、测试套件等非必需内容打包进最终镜像，降低攻击面和传输开销。
1、第一阶段使用php:8.2-cli作为构建器，安装Composer并执行composer install --no-dev --optimize-autoloader。
2、第二阶段基于php:8.2-apache-slim，仅复制vendor目录和源码文件。
3、在第二阶段中禁用未使用的Apache模块以精简运行时。
4、将composer.lock文件显式复制至构建器阶段，确保依赖版本锁定。
三、配置docker-compose.yml统一管理服务依赖
当PHP框架需连接MySQL、Redis等外部服务时，通过docker-compose.yml声明服务拓扑与网络策略，实现一键启停与环境隔离。
1、创建docker-compose.yml文件，定义php-app、db、redis三个service。
2、为php-app设置build上下文与环境变量：APP_ENV=prod、TZ=Asia/Shanghai。
3、配置db服务使用mysql:8.0镜像，并挂载初始化SQL脚本到/docker-entrypoint-initdb.d/。
4、在php-app与db之间添加depends_on和自定义bridge网络，确保启动顺序与DNS可达性。
5、为php-app映射宿主机端口8080到容器80端口，并挂载日志目录供外部收集。
四、使用Alpine基础镜像减小运行时体积
Alpine Linux采用musl libc与busybox，相比Debian系基础镜像可减少约70%磁盘占用，适用于资源受限或CI/CD高频拉取场景。
1、将Dockerfile首行替换为FROM php:8.2-apache-alpine。
2、改用apk包管理器安装扩展：RUN apk add --no-cache $PHPIZE_DEPS && docker-php-ext-install pdo_mysql。
3、因Alpine默认不包含systemd与部分GNU工具，需移除对sed -i、grep -E等行为强依赖的初始化脚本。
4、验证扩展加载状态：在容器内执行php -m | grep pdo_mysql，确认输出存在且无警告。
五、挂载配置文件实现环境差异化
将数据库连接参数、缓存前缀等敏感或可变配置从镜像中剥离，通过卷挂载或环境变量注入，提升镜像复用性与安全性。
1、在宿主机创建/config/php/目录，存放php.ini定制项如memory_limit = 256M。
2、修改Dockerfile，在apache配置段添加COPY ./config/php/ /usr/local/etc/php/conf.d/。
3、在docker-compose.yml中为php-app添加volumes字段，挂载./env/.env.prod:/var/www/html/.env:ro。
4、在PHP框架启动逻辑中读取$_ENV或getenv()获取DB_HOST、REDIS_URL等变量，禁止硬编码于源码中。
