当前位置：首页 > 文章列表 > 文章 > php教程 > Laravel报错：缺少ext-fileinfo扩展解决方法

Laravel报错：缺少ext-fileinfo扩展解决方法

2025-09-25 13:42:30 0浏览收藏

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《Laravel创建报错：缺少ext-fileinfo扩展解决方法》，很明显是关于文章的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

解决Laravel项目创建时ext-fileinfo扩展缺失错误

本文旨在解决在使用Composer创建Laravel项目时遇到的ext-fileinfo扩展缺失错误。该错误通常导致项目创建失败和vendor目录缺失。教程将详细指导用户如何通过修改PHP配置文件php.ini来启用fileinfo扩展，确保Laravel项目能够顺利初始化，并提供验证和注意事项。

1. 问题描述与错误分析

在使用 composer create-project laravel/laravel new-project 命令创建新的Laravel项目时，用户可能会遇到项目创建失败，并且项目目录下缺少 vendor 文件夹的问题。终端输出的错误信息通常会明确指出 ext-fileinfo * -> it is missing from your system. Install or enable PHP's fileinfo extension.。

例如，典型的错误信息如下：

composer create-project laravel/laravel new-project
...
    - league/flysystem[1.1.0, ..., 1.x-dev] require ext-fileinfo * -> it is missing from your system. Install or enable PHP's fileinfo extension.
    - Root composer.json requires laravel/framework ^8.65 -> satisfiable by laravel/framework[v8.65.0, ..., 8.x-dev].

To enable extensions, verify that they are enabled in your .ini files:
    - C:\Program Files\php-8.0.12\php.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.

这个错误表明，Composer在解析Laravel项目的依赖时，发现其中一个核心库（例如 league/flysystem，Laravel文件系统组件所依赖）需要PHP的 fileinfo 扩展，但该扩展在当前PHP环境中并未启用。fileinfo 扩展是PHP用于检测文件MIME类型和编码的关键组件，许多现代PHP框架和库都依赖它来处理文件上传、存储等操作。

2. 诊断fileinfo扩展状态

在尝试解决问题之前，首先需要确认 fileinfo 扩展是否确实未启用，以及PHP CLI（命令行界面）正在使用哪个 php.ini 文件。

查找当前PHP CLI使用的php.ini文件： 在终端中运行以下命令：
```
php --ini
```
该命令会输出PHP加载的配置文件路径，其中 Loaded Configuration File 行显示了PHP CLI正在使用的 php.ini 文件。例如：
```
Configuration File (php.ini) Path: C:\Windows
Loaded Configuration File:         C:\Program Files\php-8.0.12\php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed:      (none)
```
请务必记住 Loaded Configuration File 所示的路径，这是我们需要修改的文件。
检查fileinfo扩展是否已启用： 运行以下命令查看已加载的PHP扩展列表：
```
php -m | findstr /i fileinfo  # Windows
# 或者
php -m | grep -i fileinfo    # Linux/macOS
```
如果没有任何输出，或者 fileinfo 不在列表中，则说明该扩展未启用。

3. 启用fileinfo扩展的解决方案

解决此问题的核心是编辑正确的 php.ini 文件，并启用 fileinfo 扩展。

定位并打开php.ini文件： 根据前面 php --ini 命令的输出，找到 Loaded Configuration File 指定的 php.ini 文件。使用文本编辑器（如Notepad++、VS Code、Sublime Text等）以管理员权限打开该文件。例如，如果路径是 C:\Program Files\php-8.0.12\php.ini，就打开这个文件。
查找并取消注释fileinfo扩展： 在 php.ini 文件中，搜索 extension=fileinfo。你可能会找到类似以下的两行：
```
;extension=fileinfo
```
或者在 Dynamic Extensions 部分找到：
```
; On Windows:
; extension=php_fileinfo.dll
```
无论哪种情况，如果前面有一个分号（;），表示该行被注释掉了。你需要删除这个分号，使其变为：
```
extension=fileinfo
```
或者在Windows上：
```
extension=php_fileinfo.dll
```
确保没有额外的分号或其他字符。
保存php.ini文件： 保存你对 php.ini 文件所做的更改。
验证更改（可选但推荐）： 再次运行 php -m | findstr /i fileinfo (或 grep)。此时，你应该能看到 fileinfo 出现在已加载扩展的列表中。这表明 fileinfo 扩展已成功启用。

4. 重新创建Laravel项目

在确认 fileinfo 扩展已启用后，你可以再次尝试创建Laravel项目：

composer create-project laravel/laravel new-project

此时，Composer应该能够顺利下载所有依赖，创建 vendor 目录，并成功初始化Laravel项目。

5. 注意事项与最佳实践

多个php.ini文件： 你的系统上可能存在多个 php.ini 文件。例如，一个用于命令行接口（CLI），另一个用于Web服务器（如Apache、Nginx通过PHP-FPM）。务必修改CLI模式下使用的 php.ini 文件，因为 composer create-project 是在CLI环境下运行的。如果你的Web项目也需要 fileinfo，你可能需要修改Web服务器所使用的 php.ini 文件，并在修改后重启Web服务器或PHP-FPM服务。
权限问题： 确保你有权限修改 php.ini 文件。在某些操作系统中，可能需要以管理员身份运行文本编辑器才能保存更改。
PHP版本兼容性： 确保你使用的PHP版本与你尝试安装的Laravel版本兼容。例如，Laravel 8通常要求PHP 7.3或更高版本，PHP 8.x是完全支持的。
错误排查： 如果问题依然存在，请仔细检查 php.ini 文件中是否有语法错误，或者 extension_dir 配置是否正确指向了PHP扩展所在的目录。
Composer缓存： 虽然不直接相关，但在遇到其他Composer问题时，清理Composer缓存（composer clear-cache）有时会有帮助。

通过遵循上述步骤，可以有效地解决Laravel项目创建过程中 ext-fileinfo 扩展缺失的问题，确保项目顺利初始化。

今天关于《Laravel报错：缺少ext-fileinfo扩展解决方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！