如何处理Composer提示的“requires lib-icu”之类的系统库依赖？（环境配置）

Composer报“requires lib-icu”错误本质是PHP依赖的ICU库缺失或版本不匹配；需先用php -m检查intl扩展是否启用，再用php -i确认ICU版本，比对项目要求后决定升级系统ICU、更换PHP版本或重装intl扩展。

Composer 报 “requires lib-icu” 这类错误，本质不是 Composer 本身的问题，而是 PHP 编译时依赖的系统底层库缺失或版本不匹配。关键要区分：是 PHP 扩展没装，还是系统库里压根没有，抑或版本太低。

先确认 PHP 实际需要哪个扩展和版本

运行 php -m | grep intl 看 intl 扩展是否已启用；如果没输出，说明 intl 没装或没启用。再执行 php -i | grep "ICU version"，能看到当前 PHP 绑定的 ICU 版本（比如 70.1）。而报错里写的 “requires lib-icu ^72.0”，就表示项目要求 ICU ≥72，但你系统只有 70 —— 这时候装扩展没用，得升级系统 ICU 或换 PHP。

根据系统类型安装或升级 ICU 相关库

Ubuntu/Debian：
sudo apt update && sudo apt install libicu-dev（开发包，编译 PHP 需要）
如果已有 intl 但版本低，可能需要换源或升级系统，比如 Ubuntu 22.04 自带 ICU 70，要 ICU 72 得上 23.04+ 或手动编译 ICU。

CentOS/RHEL 8+：
sudo dnf install libicu-devel
RHEL 7 默认 ICU 太老（50.x），建议升级到 8+ 或用 SCL（Software Collections）启用较新工具链。

macOS（Homebrew）：
brew install icu4c，然后重新编译 PHP（如用 php-build、asdf 或 brew install php --with-icu4c）。

标签： php centos composer ubuntu 工具 mac macos dnf 环境配置 cos