解决Laravel项目创建时ext-fileinfo扩展缺失错误-php教程-PHP中文网

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

碧海醫心

发布： 2025-09-19 13:45:12

原创

533人浏览过

解决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 部分找到：

挖错网
一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情
```
; 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扩展缺失错误的详细内容，更多请关注php中文网其它相关文章！