docker中php版本由镜像标签决定,需显式指定如php:8.1-cli;扩展须用docker-php-ext-install安装;配置宜用conf.d下覆盖文件;时区、sapi类型、openssl等环境须全链路对齐。

PHP 版本在 Docker 里不是“装一次就完事”
你本地跑 php -v 是 8.2,但容器里跑出来是 7.4?不是环境没配好,而是镜像根本没选对。Docker 的 PHP 版本完全取决于你拉的镜像标签,php:latest 目前指向 8.3,但很多项目还卡在 8.0 或 7.4 —— 它不会自动适配你的 composer.json 或 .php-version。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 永远显式指定镜像 tag:
php:8.1-cli、php:8.0-apache,别用latest或alpine(后者默认不带pdo_mysql等扩展) - 多版本共存时,用不同
Dockerfile分离:一个项目用FROM php:7.4-fpm,另一个直接切到php:8.2-fpm,别试图在同一个容器里“切换版本” - 注意基础镜像差异:
php:8.2-cli-bullseye和php:8.2-cli-alpine3.18的包管理器、SSL 证书路径、甚至date.timezone默认值都可能不同
docker-compose.yml 里怎么安全传 PHP 配置
直接挂载 /usr/local/etc/php/php.ini 到宿主机?风险很大:容器启动时若宿主机文件不存在,PHP 进程会静默失败;更糟的是,你改了 ini 文件但忘了重启容器,以为生效了其实没 reload。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 用
php-ini-overrides.ini方式:在docker-compose.yml的volumes里只挂载覆盖文件,比如./php/conf.d/99-custom.ini:/usr/local/etc/php/conf.d/99-custom.ini - 避免覆盖整个
php.ini:Docker 官方镜像默认加载/usr/local/etc/php/conf.d/*.ini,按字母序合并,99-开头确保最后生效 - 关键配置必须验证:启动后进容器执行
php -i | grep 'memory_limit\|date.timezone',别只信配置文件名
PHP 扩展缺失导致 composer install 失败怎么办
composer install 报错 The requested PHP extension mbstring is missing?不是 Composer 问题,是容器里压根没装这个扩展。Docker 镜像默认只带最精简扩展集,pdo、mbstring、xml 这些常用项得自己加。
本文档主要讲述的是Python开发网站指南;HTML是网络的通用语言,一种简单、通用的全置标记语言。它允许网页制作人建立文本与图片相结合的复杂页面,这些页面可以被网上任何其他人浏览到,无论使用的是什么类型的电脑或浏览器 Python和其他程序语言一样,有自身的一套流程控制语句,而且这些语句的语法和其它程序语言类似,都有for, if ,while 类的关键字来表达程序流程。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 在
Dockerfile里用docker-php-ext-install显式启用:RUN docker-php-ext-install mbstring pdo pdo_mysql - 别用
apt-get install php-mbstring:Debian/Alpine 基础镜像里没有这些包,官方 PHP 镜像是从源码编译的,必须走docker-php-ext-*工具链 - 某些扩展需要额外依赖:比如
gd要先apt-get install libfreetype6-dev libjpeg62-turbo-dev libpng-dev,否则编译直接报错
本地开发和 CI 环境 PHP 版本不一致的坑
你本地用 php:8.1-apache 跑通了,CI 却用 php:8.1-cli + 自己搭 Nginx,结果 $_SERVER['REQUEST_URI'] 行为不一致,路由全崩——不是代码问题,是 SAPI 类型(Apache vs CLI vs FPM)和 Web 服务器耦合导致的。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- CI 镜像尽量复用开发镜像:用同一份
Dockerfile构建,只是CMD换成composer install && vendor/bin/phpunit - 避免在
.env或phpinfo()里硬编码版本号:用PHP_MAJOR_VERSION、PHP_MINOR_VERSION这类环境变量做条件判断 - 最易忽略的一点:时区。Docker 默认 UTC,但很多测试依赖
date('Y-m-d')输出,务必在Dockerfile加ENV TZ=Asia/Shanghai并RUN ln -sf /usr/share/zoneinfo/$TZ /etc/localtime
版本控制真正难的不是换镜像,是确认所有环境(本地、CI、预发)的 SAPI、扩展、时区、甚至 OpenSSL 版本都对齐。少一个环节,就可能在上线前最后一刻崩掉。










