无法安装Laravel？依赖冲突与PHP扩展缺失问题求助

问题描述 #

安装Laravel 9时遇到Composer依赖报错，具体信息如下：

Problem 1
    - laravel/framework[v9.36.4, ..., 9.x-dev] require league/flysystem ^3.8.0 -> satisfiable by league/flysystem[3.8.0, ..., 3.x-dev].
    - laravel/framework[v9.19.0, ..., v9.36.3] require league/flysystem ^3.0.16 -> satisfiable by league/flysystem[3.0.16, ..., 3.x-dev].
    - league/flysystem[3.0.16, ..., 3.x-dev] require league/mime-type-detection ^1.0.0 -> satisfiable by league/mime-type-detection[1.0.0, ..., 1.11.0].
    - league/mime-type-detection[1.0.0, ..., 1.3.0] require php ^7.2 -> your php version (8.1.13) does not satisfy that requirement.
    - league/mime-type-detection[1.4.0, ..., 1.11.0] require ext-fileinfo * -> it is missing from your system. Install or enable PHP's fileinfo extension.
    - Root composer.json requires laravel/framework ^9.19 -> satisfiable by laravel/framework[v9.19.0, ..., 9.x-dev].

To enable extensions, verify that they are enabled in your .ini files:
    - C:\php-8.1.13\php.ini
You can also run `php --ini` in a terminal to see which files are used by PHP in CLI mode.
Alternatively, you can run Composer with `--ignore-platform-req=ext-fileinfo` to temporarily ignore these required extensions.

核心原因 #

报错的关键是系统未启用PHP的fileinfo扩展：依赖链中适配PHP8.1的league/mime-type-detection版本（1.4.0+）需要fileinfo扩展，而低版本的该组件不兼容PHP8.1，所以必须启用fileinfo来让Composer选择兼容的依赖版本。

解决步骤 #

1. 启用PHP的fileinfo扩展 #

• 打开终端，运行php --ini，找到CLI模式下加载的php.ini文件路径（比如示例中的C:\php-8.1.13\php.ini）
• 用文本编辑器打开该php.ini文件，找到行;extension=fileinfo，删除开头的分号;，保存文件
• 重启你的Web服务（如果使用Apache/Nginx），或者关闭并重新打开终端以刷新PHP环境
• 验证：运行php -m，查看输出列表中是否包含fileinfo

2. 重新执行安装命令 #

运行你之前使用的Laravel安装命令，比如：

composer create-project laravel/laravel your-project-name

或者如果已经初始化了项目，执行：

composer install

3. 临时应急方案（不推荐生产环境使用） #

如果暂时无法启用fileinfo扩展，可以临时让Composer忽略该依赖要求：

composer install --ignore-platform-req=ext-fileinfo

⚠️ 注意：此方案仅用于测试环境临时绕过问题，生产环境必须启用fileinfo，否则Laravel的文件上传、MIME类型检测等核心功能会失效。

内容的提问来源于stack exchange，提问作者Shafiur Rahman Sifat