在Laravel 8、PHP 8环境下安装maatwebsite/excel失败如何解决

首先明确版本兼容性：Laravel 8 + PHP 8 环境仅支持 maatwebsite/excel 3.1.35 及以上的 3.1 分支版本，低于该版本的安装包不兼容 PHP 8，会直接触发依赖冲突。 #

操作步骤 #

• 先移除已安装的不兼容版本（若此前安装失败）

composer remove maatwebsite/excel

若 composer.json 中仍有旧版本的 maatwebsite/excel 版本约束，手动删除对应行后再执行下一步。

• 安装匹配的兼容版本，执行命令：

composer require maatwebsite/excel:^3.1.35 -W

-W 参数允许自动升级关联依赖到兼容版本，避免嵌套依赖冲突。 #

常见问题排查 #

• 若仍提示依赖缺失，先检查是否安装了 required 扩展：php-zip、php-xml、php-gd、php-mbstring，需安装对应 PHP 8 版本的扩展后再重试安装。
• 若遇网络下载失败，可先切换 composer 国内镜像：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

• 若仍有平台版本检测冲突，可临时添加参数跳过检测（不建议长期使用，优先修复本地环境配置）：

composer require maatwebsite/excel:^3.1.35 -W --ignore-platform-reqs

安装后配置 #

Laravel 8 默认开启包自动发现，无需手动注册服务提供者。若关闭了自动发现，需在 config/app.php 中添加如下配置：

• providers 数组中添加：

Maatwebsite\Excel\ExcelServiceProvider::class,

• aliases 数组中添加：

'Excel' => Maatwebsite\Excel\Facades\Excel::class,

最后发布配置文件即可正常使用：

php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"

内容的提问来源于stack exchange，提问作者Abdullah Al Mamun