构建轻量级PHP基础镜像需基于Alpine Linux，使用php:8.3-cli-alpine，安装opcache等扩展，禁用display_errors，通过php.ini覆盖配置；分离Nginx与PHP-FPM为独立容器，docker-compose定义服务并挂载代码，PHP-FPM设ondemand模式；启用OPcache预编译，绑定/dev/shm共享内存；采用多阶段构建，builder阶段装composer并安装依赖，运行阶段仅复制优化后文件并以www-data非root运行；集成Healthcheck探针，通过/health和/ping路径检测就绪状态。
一、构建轻量级PHP基础镜像
基于Alpine Linux构建最小化PHP运行时镜像，可显著减少攻击面与启动延迟。Alpine提供musl libc和BusyBox，体积通常不足10MB，适配2026年对资源效率的严苛要求。
1、创建Dockerfile，指定FROM php:8.3-cli-alpine作为基础层。
2、使用apk add --no-cache安装必要扩展：php83-opcache、php83-mbstring、php83-curl。
3、删除默认index.php并禁用display_errors，通过ENV PHP_INI_SCAN_DIR=/etc/php/conf.d设置配置加载路径。
立即学习“PHP免费学习笔记（深入）”；
4、执行COPY ./php.ini /usr/local/etc/php/conf.d/99-custom.ini覆盖默认配置。
二、分离Nginx与PHP-FPM为独立容器
解耦Web服务器与应用处理器，实现进程隔离与弹性扩缩。Nginx容器仅处理静态资源与反向代理，PHP-FPM容器专注脚本执行，符合2026微服务协同部署范式。
1、编写docker-compose.yml，定义nginx与php-fpm两个service。
2、在nginx service中挂载./html:/usr/share/nginx/html:ro与./nginx.conf:/etc/nginx/nginx.conf:ro。
3、在php-fpm service中挂载./src:/var/www/html:ro，并设置network_mode: "service:nginx"以复用网络栈。
4、配置php-fpm pool为ondemand模式，通过pm.max_children=15与pm.start_servers=3控制并发资源占用。
三、启用OPcache预编译与共享内存优化
利用PHP 8.3的OPcache改进特性，在容器启动时完成字节码缓存初始化，避免冷启动性能抖动。共享内存段绑定至/dev/shm，规避磁盘I/O瓶颈。
1、在php.ini中设置opcache.enable=1与opcache.enable_cli=1。
2、设定opcache.memory_consumption=256与opcache.interned_strings_buffer=16提升缓存容量。
3、添加opcache.preload=/var/www/html/preload.php且确保preload.php中使用opcache_compile_file()显式加载核心类文件。
4、在Dockerfile中RUN mkdir -p /dev/shm && mount -t tmpfs -o size=256M tmpfs /dev/shm保证内存挂载可用。
四、配置多阶段构建消除构建依赖
将编译期工具链与运行时环境彻底分离，最终镜像不包含任何gcc、make或composer二进制文件，降低镜像体积并增强安全性。
1、第一阶段使用php:8.3-cli-alpine作为builder，RUN apk add --no-cache composer && composer install --no-dev --optimize-autoloader。
2、第二阶段使用同一基础镜像，COPY --from=0 /var/www/html /var/www/html。
3、在第二阶段中移除vendor/bin目录及所有.*ignore文件，仅保留autoload.php与优化后的classmap。
4、设置USER 82:82（www-data UID/GID）并限制容器以非root身份运行。
五、集成Healthcheck与就绪探针
通过容器原生健康检查机制实时反馈PHP-FPM子进程状态，避免Kubernetes或Swarm将流量路由至未就绪实例，保障2026高可用架构下请求零丢弃。
1、在php-fpm service中添加healthcheck指令：CMD ["sh", "-c", "curl -f http://localhost:9000/health || exit 1"]。
2、在Nginx配置中暴露/health路径，返回200且响应体为OK。
3、设置healthcheck间隔为10s，超时5s，失败阈值3次，成功阈值2次。
4、在PHP-FPM pool配置中启用ping.path = /ping并确保ping.response = pong，供底层探测调用。
