该错误源于 php 的国际化扩展（intl）未启用，导致 symfony console 组件在处理字符串长度计算时无法调用 `normalizer` 类；只需安装并启用 `php-intl` 扩展即可修复。

在 Laravel 项目中执行 composer install 或 composer update 时出现 Fatal error: Class 'Normalizer' not found，根本原因并非代码问题，而是当前 PHP 环境缺少 intl 扩展——该扩展提供了 Normalizer、Collator、Locale 等关键国际化类，而 Symfony Console（特别是 ProgressBar 和 Helper 组件）在格式化控制台输出时依赖 Normalizer::normalize() 来正确处理 Unicode 字符串宽度，尤其在含 emoji、中文或重音符号的进度条文本中至关重要。

✅ 解决方案：安装并启用 php-intl

根据你的系统环境，执行对应命令：

▪ Ubuntu/Debian（推荐，适配 PHP 7.4+）

# 查看当前 PHP 版本（确认主版本号）
php -v

# 安装 intl 扩展（以 PHP 7.4 为例）
sudo apt update
sudo apt install php7.4-intl

# 若使用 PHP 8.x，请替换为：
# sudo apt install php8.1-intl   # 或 php8.2-intl / php8.3-intl

▪ CentOS/RHEL / AlmaLinux（使用 dnf/yum）

# PHP 7.4+
sudo dnf install php-intl

# 或旧版 yum（如 CentOS 7）
sudo yum install php-intl

▪ macOS（通过 Homebrew + PHP）

# 若使用 brew 安装的 PHP（如 php@8.2）
brew install php@8.2-int
l
# 并确保 extension_dir 和 extension=intl.so 已写入 php.ini

▪ 验证是否生效

安装完成后，重启 Web 服务器（如 Apache/Nginx）及 PHP-FPM（如使用），然后运行：

php -m | grep intl
# 应输出：intl

php -r "var_dump(class_exists('Normalizer'));"
# 应输出：bool(true)

⚠️ 注意事项： 不要仅修改 php.ini 添加 extension=intl，若未实际安装扩展包，PHP 启动会报 Failed loading extension 错误； 多版本 PHP 共存时（如 php7.4, php8.1），务必为当前 CLI 使用的 PHP 版本安装对应 php*-intl 包（可用 which php 和 php -i | grep "Loaded Configuration File" 确认）； Docker 用户请在 Dockerfile 中添加 RUN apt-get install -y php${PHP_VERSION}-intl 并重建镜像。

完成上述步骤后，再次执行 composer install 即可正常进行，Symfony 进度条与 Laravel 安装流程将不再因 Normalizer 缺失而中断。此扩展不仅是 Composer 的依赖，更是 Laravel 本地化（Lang, trans()）、日期格式化（Carbon::locale()）及 JSON 响应标准化等功能的基础支撑。

立即学习“PHP免费学习笔记（深入）”；

# php  # linux  # laravel  # centos  # js  # json  # docker  # composer  # php8  # php7  # symfony  # carbon  # nginx  # Error  # 字符串  # class  # console  # macos  # apache  # ubuntu  # debian  # 会报  # 进度条  # 只需  # 请在  # 仅是  # 镜像  # 为例  # 等功能  # 重启  # 至关重要 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何基于云服务器快速搭建个人网站？  Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  如何在VPS电脑上快速搭建网站？  Laravel如何使用Livewire构建动态组件？（入门代码）  如何在阿里云域名上完成建站全流程？  Swift中swift中的switch 语句  Android Socket接口实现即时通讯实例代码  Laravel如何使用集合（Collections）进行数据处理_Laravel Collection常用方法与技巧  Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】  Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程  如何快速生成橙子建站落地页链接？  详解ASP.NET 生成二维码实例（采用ThoughtWorks.QRCode和QrCode.Net两种方式）  Laravel如何配置Horizon来管理队列？（安装和使用）  LinuxShell函数封装方法_脚本复用设计思路【教程】  北京网页设计制作网站有哪些,继续教育自动播放怎么设置？  如何撰写建站申请书？关键要点有哪些？  javascript基于原型链的继承及call和apply函数用法分析  如何在IIS中新建站点并配置端口与IP地址？  长沙企业网站制作哪家好,长沙水业集团官方网站？  北京网站制作公司哪家好一点,北京租房网站有哪些？  Laravel请求验证怎么写_Laravel Validator自定义表单验证规则教程  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站？  新三国志曹操传主线渭水交兵攻略  香港网站服务器数量如何影响SEO优化效果？  微信推文制作网站有哪些,怎么做微信推文，急？  详解一款开源免费的.NET文档操作组件DocX（.NET组件介绍之一）  详解Android——蓝牙技术 带你实现终端间数据传输  Python结构化数据采集_字段抽取解析【教程】  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  Claude怎样写约束型提示词_Claude约束提示词写法【教程】  jquery插件bootstrapValidator表单验证详解  如何在建站之星网店版论坛获取技术支持？  如何为不同团队 ID 动态生成多个“认领值班”按钮  Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】  Java垃圾回收器的方法和原理总结  网站制作价目表怎么做,珍爱网婚介费用多少？  如何快速启动建站代理加盟业务？  Laravel如何使用Sanctum进行API认证？（SPA实战）  Python正则表达式进阶教程_复杂匹配与分组替换解析  Android自定义listview布局实现上拉加载下拉刷新功能  Laravel怎么上传文件_Laravel图片上传及存储配置  深圳防火门网站制作公司,深圳中天明防火门怎么编码？  IOS倒计时设置UIButton标题title的抖动问题  Laravel如何自定义错误页面（404, 500）？（代码示例）  利用 Google AI 进行 YouTube 视频 SEO 描述优化  Laravel如何安装使用Debugbar工具栏_Laravel性能调试与SQL监控插件【步骤】  JavaScript中如何操作剪贴板_ClipboardAPI怎么用  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网