ext-intl扩展缺失需安装并启用,该扩展提供国际化功能如语言、时区处理;通过修改php.ini启用或系统包管理安装,最后重启服务验证即可解决Composer报错。
遇到
"requires ext-intl * but it is not present"
错误,说明你的 PHP 环境缺少
ext-intl
扩展。这个扩展是 PHP 的国际化扩展(Internationalization Functions),基于 ICU 库实现,常被 Laravel、Symfony 等框架或一些依赖包所使用。
什么是 ext-intl 扩展?
ext-intl 提供了处理语言、时区、日期格式、货币格式等国际化的功能,例如
MessageFormatter
、
NumberFormatter
、
Locale
类等。Composer 检测到项目依赖中要求该扩展,但当前 PHP 环境未启用,因此报错。
如何解决 ext-intl 缺失问题?
根据你的
操作系统
和 PHP 安装方式,选择对应方法安装并启用 ext-intl 扩展。
Windows 系统(使用 XAMPP / WAMP / 手动安装 PHP)
1. 打开
php
.ini 文件(通常位于 PHP 安装目录,如
)
2. 查找并取消注释以下行(删除前面的分号):
3. 保存文件,重启 Apache 或 PHP 服务
4. 使用命令验证是否启用:
如果看到
输出,说明已成功加载。
macOS 系统(使用 Homebrew 安装 PHP)
1. 确保已安装 PHP,并通过 brew 管理:
2. ext-intl 通常随 PHP 一起安装,但可能未启用。检查 php.ini 是否启用:
3. 若未启用,编辑 php.ini 文件,添加或取消注释:
4. 保存后重启 Web 服务(如 Apache 或 php-fpm)
Linux 系统(Ubuntu/Debian)
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
1. 安装 php-intl 包(根据你的 PHP 版本调整):
例如,PHP 8.1 用户可运行:
2. 安装完成后,重启 Web 服务:
或如果你使用的是 php-fpm:
Docker 环境
在 Dockerfile 中添加安装命令:
然后重新构建镜像并运行容器。
验证 ext-intl 是否生效
运行以下命令检查:
或创建一个 PHP 文件:
输出 OK 表示已加载。
临时绕过(不推荐生产环境使用)
若仅需快速安装依赖且确认项目不实际使用 intl 功能,可临时跳过平台依赖:
但建议始终修复环境问题,避免运行时错误。
基本上就这些。确保 PHP 配置正确、扩展已安装并启用,即可解决该 Composer 报错。
C:\xampp\php\php.ini
extension=intl
php -m | grep intlintlbrew install php@8.1 # 示例版本,按实际调整grep "extension=intl" $(php --ini | grep "Loaded Configuration File" | awk '{print $4}')extension=intl
sudo apt-get update
sudo apt-get install php-intl
sudo apt-get install php8.1-intlsudo systemctl restart apache2sudo systemctl restart php8.1-fpm
# 对于 Debian/Ubuntu 基础镜像
RUN apt-get update && apt-get install -y php-intl
或针对特定 PHP 版本
RUN docker-php-ext-install intl
php -m | grep intlcomposer install --ignore-platform-req=ext-intl