composer 提示 "requires lib-icu >= ..." 系统库依赖问题怎么办？

首先检查PHP的ICU版本是否满足要求，若不满足则通过系统包管理器升级lib-icu或重新编译intl扩展；推荐优先使用apt升级或安装新版PHP，无法升级时可引入symfony/polyfill-intl-*兼容包，避免在生产环境用platform配置伪造版本。

= ...\" 系统库依赖问题怎么办？">

当你在使用 Composer 安装或更新 PHP 包时遇到类似 "Your system has an incompatible version of lib-icu" 或 "requires lib-icu >= 60.2" 这样的提示，说明当前系统安装的 ICU 库版本过低，无法满足某些 PHP 扩展（如 intl）或依赖它的包（如 symfony/polyfill-intl-*、symfony/translation 等）的要求。

检查当前 ICU 版本

先确认你的系统和 PHP 中 ICU 的实际版本：

这会输出当前 PHP intl 扩展使用的 ICU 版本。如果它低于报错中要求的版本（比如 60.2），就需要升级。

查看系统 ICU 安装情况

在 Linux 上，可通过以下命令查看系统 ICU 版本：

如果没有这个命令，尝试：

或者在 Debian/Ubuntu 上：

绘蛙AI商品图

电商场景的AI创作平台，无需高薪聘请商拍和文案团队，使用绘蛙即可低成本、批量创作优质的商拍图、种草文案

178

查看详情

在 CentOS/RHEL 上：

解决方案：升级 ICU 和 intl 扩展

ICU 是一个 C++ 国际化库，PHP 的 intl 扩展依赖它。你不能单独升级 ICU 而不重新编译 intl，常见解决方式有：

• 通过系统包管理器升级（推荐优先尝试）
  在 Ubuntu/Debian 上： sudo apt update && sudo apt upgrade libicu-dev libicu7x 升级后重启 PHP-FPM 或 Apache：
  sudo systemctl restart php-fpm
• 重新编译 PHP intl 扩展
  如果系统包太旧，可手动下载新版 ICU 并重新编译 PHP intl 扩展。但操作复杂，建议升级整个 PHP 版本。
• 升级 PHP 版本
  新版 PHP 通常绑定较新的 ICU。例如 PHP 8.1+ 多数搭配 ICU ≥ 69。
  使用 Ondřej Surý 的 PPA（Ubuntu/Debian）可轻松安装新版 PHP： sudo add-apt-repository ppa:ondrej/php
  sudo apt update
  sudo apt install php8.2
• 使用 symfony/polyfill-intl-* 兼容包
  如果无法升级系统 ICU，可让项目使用纯 PHP 实现的 polyfill 替代： composer require symfony/polyfill-intl-normalizer symfony/polyfill-intl-idn 多数 Symfony 组件会自动 fallback 到 polyfill，避免强依赖系统 ICU。

临时绕过（不推荐生产环境）

如果你只是想跳过依赖检查（比如 CI 环境），可在 composer.json 中添加平台配置，模拟高版本 ICU：

这会让 Composer 认为你有足够高的 ICU 版本，但运行时若功能缺失仍可能出错。

基本上就这些。关键是让系统 ICU、PHP intl 和项目需求三者匹配。优先升级系统包或 PHP 版本最稳妥。polyfill 是兼容旧环境的好帮手。不要强行 platform 欺骗生产环境。

以上就是composer 提示 "requires lib-icu >= ..." 系统库依赖问题怎么办？的详细内容，更多请关注php中文网其它相关文章！