解决Laravel项目启动失败：缺失fileinfo扩展的终极指南

本文旨在帮助初学者解决在Windows 10环境下，使用Laravel创建新项目时遇到的“Your requirements could not be resolved to an installable set of packages”错误，该错误通常是由于PHP的fileinfo扩展未启用所致。通过本文，你将学会如何找到并启用fileinfo扩展，从而顺利启动你的Laravel项目。

在Windows 10环境下，当你尝试使用Laravel创建新项目时，可能会遇到以下错误：

Your requirements could not be resolved to an installable set of packages.
 Problem 1
  - laravel/framework[v8.65.0, ..., 8.x-dev] require league/flysystem ^1.1 -> satisfiable by league/flysystem[1.1.0, ..., 1.x-dev].
  - 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.13\php.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.

这个错误信息表明，你的PHP环境中缺少 fileinfo 扩展。fileinfo 扩展用于检测文件的类型和编码信息，Laravel框架及其依赖包需要它才能正常运行。解决这个问题的方法就是启用 fileinfo 扩展。

步骤 1：找到正确的 php.ini 文件

错误信息中已经提示了 php.ini 文件的位置，例如：C:\Program Files\php-8.0.13\php.ini。但为了确保你编辑的是PHP CLI使用的配置文件，最好通过命令行确认。打开你的终端（如PowerShell或CMD），运行以下命令：

php --ini

该命令会输出PHP使用的配置文件路径。确认显示的路径与错误信息中提示的路径一致。

步骤 2：编辑 php.ini 文件

1. 打开 php.ini 文件： 使用文本编辑器（如Notepad++，Sublime Text等，推荐使用管理员权限打开，以避免保存权限问题）打开 php.ini 文件。
2. 查找 fileinfo 扩展： 在文件中搜索 ;extension=fileinfo。注意，前面的分号（;）表示该行是注释，也就是该扩展当前未启用。
3. 启用 fileinfo 扩展： 删除 extension=fileinfo 前面的分号（;），使其变为 extension=fileinfo。
4. 保存文件： 保存修改后的 php.ini 文件。

步骤 3：重启Web服务器（如果使用）

如果你在使用Web服务器（如Apache或Nginx）来运行Laravel项目，需要重启Web服务器才能使配置生效。

步骤 4：验证 fileinfo 扩展是否已启用

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

27

查看详情

在终端中运行以下命令：

php -m

该命令会列出所有已启用的PHP扩展。确认 fileinfo 出现在列表中。

步骤 5：重新创建Laravel项目

现在，你可以再次尝试创建Laravel项目：

laravel new myNewSite

如果一切顺利，错误应该已经消失，Laravel项目可以成功创建。

注意事项：

• 确保你编辑的是正确的 php.ini 文件，特别是当你安装了多个PHP版本时。
• 在编辑 php.ini 文件后，一定要重启Web服务器（如果使用）。
• 如果仍然遇到问题，可以尝试重启计算机。
• 如果你的 php.ini 文件中没有 extension=fileinfo 这一行，可以手动添加。

总结：

启用 fileinfo 扩展是解决Laravel项目启动失败的常见方法之一。通过本文提供的步骤，你应该能够轻松地找到并启用该扩展，从而顺利创建和运行你的Laravel项目。记住，仔细检查配置文件路径，并重启Web服务器，是确保配置生效的关键。

以上就是解决Laravel项目启动失败：缺失fileinfo扩展的终极指南的详细内容，更多请关注php中文网其它相关文章！