CLI下php -m显示intl但Composer报missing，说明当前shell中php命令路径与phpenv管理版本不一致，或php二进制未编译intl（需检查INTL_ICU_VERSION常量）、或Web服务器使用独立PHP环境导致配置分裂。
php -m 显示 intl 但 Composer 仍报 missing
这说明 CLI 环境下 intl 扩展已加载，但 Composer 检查的是当前 PHP 的「平台需求」（platform requirements），它依赖 php -v 和 php -m 输出，而某些情况下这两者不一致——比如你用的是 phpenv 切换的 PHP 版本，但 php 命令实际指向系统默认 PHP（如 /usr/bin/php），而非 phpenv 管理的版本。
验证方式：运行 which php 和 phpenv which php，如果路径不同，Composer 就会读错环境。
- 用
phpenv rehash刷新 shims - 确认当前 shell 已激活版本：
phpenv version应显示类似8.2.12 (set by /path/to/project/.php-version) - 临时指定 PHP 路径运行 Composer：
PHP_BINARY=$(phpenv which php) composer install
phpenv 下 intl 扩展未编译进 PHP 本体
phpenv 默认使用 php-build 编译 PHP，但 intl 是可选扩展，需显式启用——尤其在 macOS 或自定义编译时，若系统缺少 ICU 库或编译参数未包含 --enable-intl，生成的 PHP 二进制里根本不存在 intl 符号，此时即使修改 php.ini 也无效。
检查方法：运行 php -r "echo INTL_ICU_VERSION;"。若报 Fatal error: Undefined constant 'INTL_ICU_VERSION'，说明 intl 未编译进 PHP。
立即学习“PHP免费学习笔记（深入）”；
- 先确保系统有 ICU：
brew install icu4c（macOS）或sudo apt-get install libicu-dev（Ubuntu） - 卸载当前版本：
phpenv uninstall 8.2.12 - 设置编译变量：
export CONFIGURE_OPTS="--enable-intl --with-icu-dir=$(brew --prefix icu4c)" - 重新安装：
phpenv install 8.2.12
phpenv + Apache/Nginx 时 Web 端仍报错
phpenv 管理的是 CLI PHP，而 Apache 或 PHP-FPM 使用的是系统级 PHP（如 /usr/sbin/php-fpm），二者完全隔离。你在 phpenv 下装好 intl，对 Web 请求毫无影响。
典型现象：浏览器访问 info.php 中找不到 intl，但终端 php -m | grep intl 能看到——这就是环境分裂。
- 如果你用的是 PHP-FPM，确认 FPM 配置中
php_admin_value[extension]或池配置没覆盖掉 intl - 更稳妥的做法是：直接用 phpenv 安装的 PHP 启动 FPM（需手动配置 systemd 或 supervisord），而非依赖系统包
- 或者放弃 phpenv 管理 Web 环境，改用 Docker 或统一用系统包管理（如
sudo apt install php8.2-intl）
跳过 intl 检查的风险与替代方案
composer install --ignore-platform-req=ext-intl 能绕过安装阶段报错，但 CodeIgniter、Symfony、Pimcore 等框架启动时仍会因调用 collator_create() 或 locale_accept_from_http() 报致命错误——这不是 Composer 能屏蔽的层面。
真正安全的降级方案是引入 polyfill：
- 运行
composer require symfony/polyfill-intl-idn symfony/polyfill-intl-normalizer - 注意：
symfony/polyfill-intl-grapheme只覆盖 grapheme_* 函数，不解决 collator、locale、numberformatter 等核心类缺失问题 - polyfill 无法替代 ICU 数据库，像复杂排序、时区名称本地化等仍会退化或出错
intl 不是“可选装饰”，它是现代 PHP 国际化能力的底层支柱；临时跳过只会把问题拖到运行时，且更难定位。
