选对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 中用不同服务名定义不同版本任务。

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 这种后缀都不能省。