应选php:8.3-fpm-alpine构建轻量镜像，但需按官方契约安装扩展（docker-php-ext-install）、显式设时区、启用OPcache并重启FPM；多阶段构建分离依赖与运行环境，禁用root运行。
直接用 php:8.2-cli 启 Web 服务会失败，php:8.2-fpm-alpine 不装依赖就启用 gd 或 imagick 会报错，硬改 php.ini 文件却不重启 FPM 进程，配置根本不会生效——这些不是配置问题，是镜像构建逻辑没对齐 PHP 官方镜像的设计契约。
选对基础镜像：apache、fpm、alpine 的真实差异
官方 php 镜像按用途分三类，不是版本不同，而是预装内容和启动行为完全不同：
-
php:8.3-apache：自带 Apache + mod_php，COPY代码后开箱即用，但默认禁用.htaccess，需在Dockerfile中显式启用AllowOverride All -
php:8.3-fpm（Debian）：只含 PHP-FPM 进程，无 Web 服务器，适合与 Nginx 分离部署；扩展安装稳定，兼容性好，但镜像体积大（~120MB） -
php:8.3-fpm-alpine：轻量（~60MB），但 musl libc 导致部分二进制扩展（如某些grpc或旧版sqlsrv）无法加载；date.timezone必须显式设置，否则DateTime构造触发警告
别为了“小”盲目切 Alpine。如果项目用了 imagick 或 gd，得先 apk add --no-cache freetype-dev libpng-dev libjpeg-turbo-dev 再 docker-php-ext-configure gd，漏一步就编译失败。
扩展安装必须用 docker-php-ext-install，别碰 apt
在官方 PHP 镜像里执行 apt-get install php-mbstring 看似省事，实则埋雷：官方镜像用源码编译路径（/usr/local/...），而 apt 包管理装到 /usr/lib/php/...，php -m 找不到，php -v 可能直接报段错误。
立即学习“PHP免费学习笔记（深入）”；
- 扩展必须走
docker-php-ext-install（如mbstring、pdo_mysql）或pecl install（如redis、opcache） - 安装后务必加
docker-php-ext-enable（pecl安装的才需要，docker-php-ext-install自动启用） - 所有
RUN指令末尾加&& rm -rf /var/lib/apt/lists/*（Debian）或&& apk del .build-deps（Alpine），否则缓存膨胀，多阶段构建也救不回来
php.ini 配置生效的关键动作：路径、顺序、重启
把自定义 php.ini COPY 进去，phpinfo() 里看到的还是旧值？常见原因有三个：
- PHP 加载顺序固定：
/usr/local/etc/php/php.ini是主配置，但扩展配置从/usr/local/etc/php/conf.d/下按字母序读取；单独改opcache.ini比覆盖整个php.ini更安全 - 修改后不重启进程无效：FPM 场景下
kill -USR2 1或docker restart，不是nginx -s reload那种 reload - 验证不能只看
Loaded Configuration File，要跑php --ini确认conf.d路径被扫描，再用php -m | grep opcache看扩展是否真加载
多阶段构建不是可选项，是生产必需
构建阶段装 composer、nodejs、git，运行阶段只复制 /var/www/html 和编译好的扩展，这是压缩镜像、隔离敏感信息（如 .env、composer.json）的底线操作。
- builder 阶段用
php:8.3-cli或composer:2镜像，装完依赖后COPY --from=builder /app/vendor /var/www/html/vendor - 运行阶段必须用
php:8.3-fpm-alpine或php:8.3-fpm，且以www-data用户启动，禁止root - 别在运行阶段
RUN chown -R www-data:www-data /var/www/html—— 权限已在基础镜像中预设，挂载卷时反而会冲突
Alpine 下 pm.max_children 默认值偏高，容易 OOM；opcache.memory_consumption 在容器里建议设为 128M 起步；这些参数调优不在 Dockerfile 里写死，而应通过环境变量或 conf.d 动态注入——因为同一镜像可能跑在 1GB 或 4GB 内存的节点上。
