在 Ubuntu Docker 环境中通过 apt 安装 PHP 8.x 扩展后，Apache 下模块正常加载，但 CLI（php -v/php -m）却报“函数未定义”错误——根本原因是 CLI 默认指向了系统中另一版本（如 PHP 8.1）的二进制及配置，导致已安装的 8.0 扩展未被加载。
在 ubuntu docker 环境中通过 apt 安装 php 8.x 扩展后，apache 下模块正常加载，但 cli（`php -v`/`php -m`）却报“函数未定义”错误——根本原因是 cli 默认指向了系统中另一版本（如 php 8.1）的二进制及配置，导致已安装的 8.0 扩展未被加载。
这个问题看似是“模块没装全”，实则是 PHP 多版本共存下的默认链路错位。当你执行 apt-get install php8.0-* 时，Debian/Ubuntu 系统会将各模块（如 php8.0-mbstring）正确安装到 /usr/lib/php/8.0/ 并生成对应的 .ini 文件（如 /etc/php/8.0/cli/conf.d/15-mbstring.ini），但前提是 CLI 的 php 命令实际调用的是 php8.0 二进制，并读取 /etc/php/8.0/cli/php.ini 及其 conf.d/ 目录。
而现实情况是：Ubuntu 18.04+ 的 php 命令由 update-alternatives 管理，它可能将 php 符号链接指向了未安装扩展的其他版本（例如你未显式安装但系统残留或间接引入的 php8.1）。这就是为何 php -i 显示配置路径为 /etc/php/8.1/cli/php.ini —— CLI 根本没走到你安装的 8.0 模块目录。
✅ 正确解法不是手动编辑 php.ini 或硬编码 extension=，而是统一 CLI 的 PHP 主版本入口：
# 安装指定版本的 PHP 及全部扩展（注意：所有包名必须严格匹配目标版本）
RUN apt-get update && \
apt-get install -y \
php8.0 \
php8.0-curl php8.0-gd php8.0-gettext php8.0-gmp \
php8.0-iconv php8.0-imap php8.0-intl php8.0-mbstring \
php8.0-mysql php8.0-oauth php8.0-redis php8.0-xdebug \
php8.0-xml php8.0-yaml php8.0-zip \
libapache2-mod-php8.0 # 推荐显式指定版本，避免隐式依赖冲突
# 关键一步：强制 update-alternatives 将 'php' 命令指向 php8.0
RUN update-alternatives --set php /usr/bin/php8.0
# 验证（可选，用于调试阶段）
RUN php -v && php -m | grep -E "(mbstring|curl|redis)" && echo "✓ CLI modules confirmed"
? 重要注意事项：
- libapache2-mod-php 包名需与 PHP 版本一致（如 libapache2-mod-php8.0），否则 Apache 可能加载错误版本；
- update-alternatives --set php /usr/bin/php8.0 必须在 php8.0 包安装完成后执行，且路径需准确（可通过 ls /usr/bin/php* 确认）；
- 若需同时支持多版本开发，应使用 update-alternatives --config php 交互式切换，而非硬编码 --set；
- 不要删除 /etc/php/8.1/ 目录来“解决”问题——这属于治标不治本，且可能破坏其他依赖。
? 进阶建议：在生产 Dockerfile 中，推荐显式声明 PHP_VERSION=8.0 变量并统一使用，提升可维护性：
ARG PHP_VERSION=8.0
RUN apt-get install -y php${PHP_VERSION} php${PHP_VERSION}-mbstring php${PHP_VERSION}-xml && \
update-alternatives --set php /usr/bin/php${PHP_VERSION}
至此，CLI 与 Apache 将真正共享同一套 PHP 核心和扩展生态，mb_internal_encoding()、curl_init() 等函数即可开箱即用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
