PHP 8.3 官方镜像无独立 php:8.3 标签，须按用途选 php:8.3-fpm-alpine（生产）、php:8.3-cli-alpine（开发）等；需手动安装 pdo_mysql、opcache、mbstring 等扩展；Nginx 与 PHP-FPM 必须分容器部署并配置自定义网络；应以非 root 用户运行、启用 OPcache 与健康检查。
直接用 docker pull php:8.3 是行不通的——PHP 官方镜像没有这个独立标签，它必须带用途后缀，比如 php:8.3-fpm 或 php:8.3-cli。部署 PHP 8.3 的核心不是“拉一个镜像就完事”，而是按实际角色选对基础镜像、补全必要扩展、隔离服务职责，并控制运行权限。
选对基础镜像：按用途挑，别碰 php:8.3
官方仓库里不存在开箱即用的 php:8.3 标签，所有有效镜像都明确标明运行模式和基础系统：
-
Web 后端（推荐生产）：用
php:8.3-fpm-alpine（轻量）或php:8.3-fpm（Debian 系，兼容性好） -
本地开发/CLI 工具：用
php:8.3-cli-alpine，适合跑 Composer、单元测试、脚本 -
全栈快速验证：可用
php:8.3-apache，但体积大、权限松散，仅限临时调试
拉取后立刻验证版本：docker run --rm php:8.3-fpm php -v
输出含 PHP 8.3.x (fpm-fcgi) 才算真正到位。
补关键扩展：默认不装 pdo_mysql、opcache、mbstring
官方镜像只保留最小运行集，常用扩展需手动启用：
-
php:8.3-fpm-alpine：用apk add --no-cache php83-opcache php83-pdo_mysql php83-mbstring -
php:8.3-fpm（Debian）：用docker-php-ext-install opcache pdo_mysql mbstring - 验证是否生效：
docker run --rm php:8.3-fpm php -m | grep -E '^(opcache|pdo|mbstring)$'，没输出就得重装
特别注意：Alpine 版本不支持 sqlsrv、oci8 等依赖 glibc 的扩展；若项目强依赖，应换用 Debian 基础镜像。
立即学习“PHP免费学习笔记（深入）”；
拆服务、配网络：Nginx 和 PHP-FPM 必须分离
不要把 Web 服务器和 PHP 进程塞进一个容器。标准做法是 Nginx 处理静态资源与反向代理，PHP-FPM 专注执行脚本：
- 在
docker-compose.yml中定义两个 service：nginx和php - 显式声明自定义网络：
networks: { default: { driver: bridge } }，否则容器间无法通过服务名（如php）通信 - Nginx 配置中写
fastcgi_pass php:9000，这里的php是 compose 里定义的服务名，不是localhost - 挂载代码时用只读方式：
volumes: - ./src:/var/www/html:ro，避免容器内误删宿主机文件
调安全与性能：非 root、OPcache、健康检查
官方镜像默认以 root 运行，且 display_errors = On，这在生产环境是高危配置：
- 在 Dockerfile 中加
user www-data，并确保/var/www/html目录权限为www-data:www-data - 启用 OPcache 并预热：
opcache.enable=1、opcache.preload=/var/www/html/preload.php - 绑定共享内存加速：
volumes: - /dev/shm:/dev/shm（尤其在 Alpine 下效果明显） - 加健康探针：
healthcheck: { test: ["CMD", "curl", "-f", "http://localhost/ping"], interval: 30s }
不复杂但容易忽略
