选对php镜像标签即可运行指定解释器，如php:8.2-cli、php:8.1-apache、php:8.3-fpm-alpine，不同后缀对应cli、apache或fpm模式，-alpine更轻量但需手动安装扩展，严禁在容器内切换版本。
PHP 用 Docker 运行指定解释器，本质是选对官方镜像标签，而不是在容器里“切换”PHP 版本。Docker 的设计原则是每个容器运行一个确定版本的 PHP，不是装一堆版本再手动切。
怎么选对 php 镜像标签
PHP 官方镜像（php）按版本和 SAPI 类型打标签，比如 php:8.2-cli、php:8.1-apache、php:8.3-fpm-alpine。关键不是“怎么换”，而是“启动时就指定好”。
-
-cli：适合命令行脚本，无 Web 服务，启动快，日志直接输出到终端 -
-apache：内置 Apache + mod_php，适合传统 .htaccess 项目，体积大，启动慢 -
-fpm：只提供 PHP-FPM 进程，需搭配 Nginx 等反向代理，生产推荐 - 带
-alpine的镜像更小但可能缺某些扩展（如gd、mbstring需手动apk add） - 不带后缀（如
php:8.2）默认指向-cli，但别依赖这个隐式行为
常见错误：以为能进容器改版本
有人跑起 php:8.1-cli 后执行 apt update && apt install php8.3 —— 这不仅破坏镜像一致性，还极大概率失败，因为官方镜像用的是精简系统（Debian slim 或 Alpine），包管理器不提供多版本 PHP 共存机制。
- Debian slim 镜像里
apt list php*基本只返回当前版本的包 - Alpine 镜像中
apk search php返回的php82、php83是互斥包，安装新版本会卸载旧版，且 FPM 服务配置路径、二进制名（php-fpm83）都不同，容易断掉 - 强行编译安装 PHP 源码？没必要，也违背容器不可变原则
需要多个 PHP 版本怎么办
不是在一个容器里装多个版本，而是启动多个容器，各跑各的版本。开发调试时用 docker run 快速验证，CI/CD 中用不同服务名定义不同版本任务。
立即学习“PHP免费学习笔记（深入）”；
docker run --rm -v $(pwd):/app -w /app php:8.0-cli php --version docker run --rm -v $(pwd):/app -w /app php:8.3-cli php --version
- 用
--rm避免残留停止的容器 -
-v和-w让本地代码可被容器内 PHP 直接访问 - CI 脚本中可循环跑多个
php:{version}-cli验证兼容性 - 若需长期运行多个版本 Web 服务，用
docker-compose.yml定义多个 service，各自指定镜像，各自暴露不同端口
自定义镜像时如何固定解释器版本
Dockerfile 第一行 FROM php:8.2-fpm-alpine 就锁死了基础解释器。后续所有操作（装扩展、复制配置）都基于该版本。千万别写成 FROM php:latest 或 FROM php。
- 扩展安装必须匹配 PHP 主版本：比如
docker-php-ext-install gd在 8.2 镜像里装的就是 8.2 的 gd 扩展 - 通过
pecl install装的扩展（如redis）也要注意兼容性，有些版本只支持到 8.1 - 修改
php.ini时，路径通常是/usr/local/etc/php/php.ini（CLI/FPM）或/usr/local/lib/php.ini（部分 Alpine 变体），不要硬编码路径，用php --ini查看实际加载位置
真正麻烦的不是“怎么跑指定版本”，而是忽略标签语义、误以为容器是虚拟机、或者在 CI 中混用 latest 导致构建结果不可重现。版本号必须显式写死，连 -alpine 这种后缀都不能省。
