答案是需启用php的intl扩展并确保ICU版本达标。首先通过php -r “echo INTL_ICU_VERSION;”和php -m | grep intl检查环境,若缺失则在linux/macOS安装php-intl扩展,windows下修改php.ini启用extension=intl,必要时升级系统ICU库,最后重启服务验证即可解决composer报错问题。

Composer 报错 “requires lib-icu youjiankuohaophpcn= 50.1″,通常出现在安装或更新 PHP 国际化相关组件(如 symfony/intl、symfony/polyfill-intl-icu 等)时。这个提示不是说你需要手动装一个叫 lib-icu 的 Composer 包,而是表明当前 PHP 环境缺少对 ICU 库的支持,或者版本过低。
ICU(International Components for Unicode)是一个用于提供国际化支持的 c++ 库,PHP 通过 intl 扩展来调用它。而 intl 扩展依赖系统中安装的 ICU 版本。当 Composer 检测到 PHP 的 intl 扩展未启用或 ICU 版本低于要求(如 50.1)时,就会报此错误。
检查当前 ICU 和 intl 扩展状态
在终端运行以下命令查看 PHP 是否启用了 intl 扩展以及 ICU 版本:
php -r "echo INTL_ICU_VERSION;n"
如果输出类似 69.1,说明已启用且版本较高,可能不是环境问题。如果提示函数不存在或报错:
Fatal Error: undefined constant INTL_ICU_VERSION
则说明 intl 扩展未启用。
也可以运行:
php -m | grep intl
如果没有输出 intl,说明扩展未加载。
解决方法一:启用 intl 扩展(Linux / macOS)
大多数 Linux 发行版和 macos 可通过包管理器安装 php-intl:
- ubuntu/debian:
sudo apt-get install php-intl - centos/RHEL(需 EPEL):
sudo yum install php-intl或dnf install php-intl - macOS(使用 Homebrew + PHP 安装):
如果你使用brew install php,通常intl已内置。否则可尝试重装:brew reinstall php
安装完成后重启 Web 服务(如 apache 或 PHP-FPM):
sudo service apache2 restart # 或 sudo systemctl restart php-fpm
解决方法二:Windows 下启用 intl 扩展
Windows 用户需编辑 php.ini 文件(可通过 php --ini 查看路径):
- 找到
;extension=intl这一行 - 去掉前面的分号,改为:
extension=intl - 保存并重启 Web 服务器
注意:某些旧版 Windows PHP 包可能缺少 icu*.dll 文件,需确保 PHP 目录下有类似 icudtXX.dll、icuinXX.dll、icuucXX.dll 的文件(XX 是版本号)。若缺失,建议重新下载完整版 PHP 包。
解决方法三:升级系统 ICU 库(较少需要)
极少数情况下,虽然启用了 intl,但系统 ICU 版本太旧(如 CentOS 7 默认 ICU 版本为 50.1.2,刚好卡线)。可考虑升级 ICU:
- 查看当前 ICU 版本:
icu-config --version(Linux) - 若版本低于 50.1,可通过源码编译升级或使用第三方仓库(如
ius或remi)更新 PHP 和依赖
例如,在 CentOS 使用 Remi 仓库:
yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm yum-config-manager --enable remi-php81 # 根据你的 PHP 版本选择 yum update php-intl
验证修复结果
运行以下命令确认问题已解决:
php -r "echo 'ICU Version: '.INTL_ICU_VERSION;n"
输出应类似:
ICU Version: 69.1
此时再运行 composer install 或 update,应该不会再出现 lib-icu >= 50.1 的报错。
基本上就这些。关键点是确保 PHP 的 intl 扩展已启用,并且系统 ICU 版本满足最低要求。多数情况只需安装或启用 php-intl 即可解决。
以上就是composer提示“requires lib-icu >= 50.1”怎么办_说明解决缺少lib-icu扩展的问题的详细内容,更多请关注php中文网其它相关文章!


