解决 Laravel 项目启动失败：缺失 fileinfo 扩展的详细教程-php教程-PHP中文网

解决 Laravel 项目启动失败：缺失 fileinfo 扩展的详细教程

霞舞

发布： 2025-10-16 11:58:21

原创

957人浏览过

解决 laravel 项目启动失败：缺失 fileinfo 扩展的详细教程

本文针对 Laravel 初学者在 Windows 10 环境下创建新项目时，因 PHP 的 fileinfo 扩展缺失导致项目无法启动的问题，提供了详细的解决方案。通过逐步指导，帮助读者找到并启用 php.ini 文件中的 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 扩展，而 Laravel 框架依赖这个扩展来正常运行。 fileinfo 扩展允许 PHP 检测文件的 MIME 内容类型和编码。以下是解决此问题的步骤：

1. 找到正确的 php.ini 文件

错误信息中已经给出了 php.ini 文件的路径，例如 C:\Program Files\php-8.0.13\php.ini。然而，为了确保你编辑的是 PHP 命令行界面 (CLI) 使用的 php.ini 文件，建议在命令行中运行以下命令：

php --ini

登录后复制

这条命令会显示 PHP 使用的配置文件路径。请注意，Web 服务器 (例如 Apache 或 Nginx) 可能使用不同的 php.ini 文件。确保你修改的是 CLI 使用的文件，因为 Laravel 项目通常在命令行中运行。

2. 编辑 php.ini 文件

使用文本编辑器（例如 Notepad++ 或 Visual Studio Code）以管理员权限打开 php.ini 文件。这是很重要的一步，因为修改系统文件通常需要管理员权限。

3. 启用 fileinfo 扩展

在 php.ini 文件中搜索 ;extension=fileinfo。找到该行后，删除行首的分号 ;，使其变为 extension=fileinfo。分号表示注释，删除分号即取消注释，从而启用该扩展。

4. 保存 php.ini 文件

保存对 php.ini 文件的更改。确保以 UTF-8 编码保存，以避免潜在的字符编码问题。

千面视频动捕

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

查看详情

5. 重启命令行窗口

关闭并重新打开你的命令行窗口（例如 PowerShell 或 cmd）。这样做可以确保 PHP 加载最新的 php.ini 配置。

6. 验证 fileinfo 扩展是否已启用

运行以下命令来验证 fileinfo 扩展是否已成功启用：

php -m | findstr fileinfo

登录后复制

如果命令输出中包含 "fileinfo"，则表示该扩展已成功启用。

7. 重新运行 Laravel 项目创建命令

现在，你可以尝试重新运行 Laravel 项目创建命令：

laravel new myNewSite

登录后复制

如果一切顺利，这次应该不会再出现关于 fileinfo 扩展的错误了。

注意事项：

权限问题： 编辑 php.ini 文件时，确保以管理员身份运行文本编辑器，否则可能无法保存更改。
Web 服务器： 如果你的 Laravel 项目需要通过 Web 服务器访问，还需要确保 Web 服务器使用的 php.ini 文件也启用了 fileinfo 扩展，并重启 Web 服务器。
多个 PHP 版本： 如果你的系统上安装了多个 PHP 版本，请确保你修改的是 Laravel 项目使用的 PHP 版本的 php.ini 文件。
编码问题： 保存 php.ini 文件时，请确保使用 UTF-8 编码。

总结：

解决 Laravel 项目启动时 fileinfo 扩展缺失的问题，关键在于找到正确的 php.ini 文件，取消注释 extension=fileinfo 行，并重启命令行窗口。通过以上步骤，你应该能够成功启用 fileinfo 扩展，并顺利创建和运行你的 Laravel 项目。如果问题仍然存在，请检查你的 PHP 配置和环境设置，确保一切配置正确。

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