本文旨在解决在使用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扩展缺失错误的详细内容，更多请关注php中文网其它相关文章！