在 ubuntu docker 环境中通过 apt 安装 php 8.x 扩展后，apache 下模块正常加载，但 cli 模式（php -v / php -m）却提示如 mbstring、curl 等函数未定义——根本原因是 cli 使用了错误的 php 版本（如 php8.1）而扩展仅安装在 php8.0 下，需统一 cli 默认版本。
在 ubuntu docker 环境中通过 apt 安装 php 8.x 扩展后，apache 下模块正常加载，但 cli 模式（php -v / php -m）却提示如 mbstring、curl 等函数未定义——根本原因是 cli 使用了错误的 php 版本（如 php8.1）而扩展仅安装在 php8.0 下，需统一 cli 默认版本。
当你在 Ubuntu 18.04（或更新版本）的 Docker 容器中执行类似以下命令安装 PHP 及扩展：
RUN apt-get update && apt-get install -y \
php8.0 php8.0-curl php8.0-gd php8.0-mbstring php8.0-xml php8.0-zip \
libapache2-mod-php表面上一切顺利：Apache 模块可用、Web 请求正常；但运行 php -m | grep mbstring 或直接调用 php -r "echo mb_internal_encoding();" 时却报错 Call to undefined function。执行 php --ini 可发现关键线索：
$ php --ini Configuration File (php.ini) Path: /etc/php/8.1/cli Loaded Configuration File: /etc/php/8.1/cli/php.ini ← 注意这里是 8.1！
而你实际安装的是 php8.0-* 包，其配置和扩展目录位于 /etc/php/8.0/ 下。问题本质是：系统存在多个 PHP 版本（如 8.0 和 8.1），/usr/bin/php 符号链接或 update-alternatives 默认指向了未安装扩展的版本（8.1）。Ubuntu 的 php 元包会自动注册 update-alternatives，但若 8.1 被意外安装（例如通过第三方源或残留包），它可能抢占 CLI 默认入口。
✅ 正确且“干净”的解决方案是在安装完成后，显式将 CLI 默认 PHP 版本切换至你实际安装并配置扩展的版本：
立即学习“PHP免费学习笔记（深入）”；
# 安装所需 PHP 8.0 及全部扩展
RUN apt-get update && apt-get install -y \
php8.0 php8.0-curl php8.0-gd php8.0-mbstring php8.0-xml php8.0-zip \
php8.0-intl php8.0-mysql php8.0-opcache \
libapache2-mod-php
# 关键一步：强制 CLI 使用 php8.0
RUN update-alternatives --set php /usr/bin/php8.0? update-alternatives --set php /usr/bin/php8.0 命令会更新系统级 php 命令的符号链接，确保 php, phpize, php-config 等均指向 8.0 版本及其对应配置目录（/etc/php/8.0/cli/），从而自动加载该版本下已安装的所有 .so 扩展。
验证是否生效，可在 Docker 构建阶段添加调试指令：
RUN php -v && \
php -m | grep -E '^(mbstring|curl|xml|zip)$' && \
php --ini | head -2预期输出应显示 PHP 8.0.x 版本，并列出所有已启用模块，且 Loaded Configuration File 明确指向 /etc/php/8.0/cli/php.ini。
⚠️ 注意事项：
-
不要手动编辑 php.ini 启用扩展（如取消 ;extension=mbstring 注释）：这不仅繁琐易错，更违背 Debian/Ubuntu 包管理规范；正确方式是安装对应 php8.0-
包，由包脚本自动处理 conf.d/ 配置。 - 若遇到 update-alternatives: error: unknown argument '--set'，说明 php 尚未被注册为替代项——此时可先运行 update-alternatives --install /usr/bin/php php /usr/bin/php8.0 80 注册，再执行 --set。
- 升级到 PHP 8.1+？只需将所有 php8.0-* 替换为 php8.1-*，并把 --set 目标改为 /usr/bin/php8.1，保持一致性即可。
总结：PHP CLI 模块缺失并非安装失败，而是多版本共存下的默认入口错配。使用 update-alternatives --set 是符合 Linux 发行版设计哲学的标准化修复方式，简洁、可靠、可复现，应作为 PHP 多版本 Docker 环境的必备初始化步骤。
