解决 Laravel ext-fileinfo 缺失导致的安装与运行异常-php教程-PHP中文网

解决 Laravel ext-fileinfo 缺失导致的安装与运行异常

花韻仙語

发布： 2025-10-28 11:36:25

原创

862人浏览过

解决 Laravel ext-fileinfo 缺失导致的安装与运行异常

本教程旨在解决laravel初次安装时遇到的ext-fileinfo扩展缺失错误，以及由此导致的php artisan serve命令无法正常工作的问题。我们将详细指导您如何在windows环境下通过编辑php.ini文件启用php_fileinfo.dll扩展，确保laravel项目能够顺利创建和运行。

问题概述

在使用 Composer 安装 Laravel 项目时，开发者可能会遇到类似以下错误信息：

Problem 1
- laravel/framework[...] require league/flysystem ^1.1 -> satisfiable by league/flysystem[...].
- league/flysystem[...] 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[...].

登录后复制

这个错误明确指出 PHP 环境缺少 fileinfo 扩展。fileinfo 扩展是 PHP 用于检测文件类型、编码等信息的关键组件，许多现代 PHP 框架（包括 Laravel）及其依赖项（如 league/flysystem）都依赖此扩展进行文件操作。即使项目表面上似乎已创建，但由于核心依赖缺失，后续的 php artisan serve 命令也可能无法正常启动开发服务器。

解决方案：启用 php_fileinfo 扩展

解决此问题的核心在于启用 PHP 配置中的 fileinfo 扩展。以下是在 Windows 环境下操作的详细步骤：

步骤一：以管理员身份打开 php.ini

php.ini 文件是 PHP 的主配置文件，通常位于 PHP 的安装目录下（例如 C:\Program Files\PHP\v7.4\php.ini 或 XAMPP/WAMP 等集成环境的相应路径）。由于修改此文件需要系统权限，建议以管理员身份打开文本编辑器。

按下 Windows 键。
在搜索栏中输入 Notepad（记事本）。
右键点击记事本应用程序，选择“以管理员身份运行”。
在以管理员身份运行的记事本中，点击“文件” -> “打开”。
在文件路径栏中输入您的 php.ini 文件所在路径，然后点击“打开”。如果您不确定 php.ini 的位置，可以通过在命令行运行 php --ini 来查找。

步骤二：编辑 php.ini 文件

打开 php.ini 文件后，您需要找到并修改或添加 fileinfo 扩展的配置行。

在 php.ini 文件中搜索 extension=php_fileinfo.dll。
如果找到该行，请检查其前面是否有分号（;）。分号表示该行被注释掉了，即扩展未启用。请删除行首的分号，使其变为：
```
extension=php_fileinfo.dll
```
登录后复制
如果未找到该行，您可以在其他 extension= 语句的下方，或文件末尾，添加这行配置：
```
extension=php_fileinfo.dll
```
登录后复制
请确保 php_fileinfo.dll 文件实际存在于您的 PHP 安装目录下的 ext 文件夹中（例如 C:\Program Files\PHP\v7.4\ext\php_fileinfo.dll）。如果不存在，您可能需要重新安装 PHP 或确保安装了完整的 PHP 发行版。

一览运营宝
一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

41

查看详情

步骤三：保存并重启相关服务

修改 php.ini 文件后，必须保存更改并重启相关的服务，使配置生效。

在记事本中，点击“文件” -> “保存”。
重启服务：
- 如果您使用的是 XAMPP、WAMP 或 Laragon 等集成环境，请通过其控制面板重启 Apache 或 Nginx 服务。
- 如果您是独立安装的 PHP，并且通过内置服务器 (php artisan serve) 运行，通常需要重启您的计算机，或者至少关闭所有当前的命令行窗口并重新打开，以确保 PHP 进程加载了新的配置。
- 对于生产环境或更复杂的开发设置，可能需要重启 PHP-FPM 服务。

验证 fileinfo 扩展是否启用

配置更改并重启服务后，您可以通过以下方式验证 fileinfo 扩展是否已成功启用：

通过命令行： 打开命令行工具，输入 php -m。在输出的扩展列表中查找 fileinfo。如果存在，则表示已启用。
```
php -m
```
登录后复制
通过 phpinfo() 函数： 创建一个名为 info.php 的文件，内容如下：
```
<?php
phpinfo();
?>
```
登录后复制
将其放置在您的 Web 服务器根目录，并通过浏览器访问该文件（例如 http://localhost/info.php）。在显示的 phpinfo 页面中搜索 fileinfo。如果找到相关信息，则表示扩展已启用。

注意事项与常见问题

php.ini 位置： 确保您修改的是当前命令行或 Web 服务器正在使用的 php.ini 文件。不同 PHP 版本或不同的安装方式（如 CLI 和 FPM/Apache 模块）可能使用不同的 php.ini 文件。使用 php --ini 是最准确的查找方法。
DLL 文件缺失： 如果 ext 目录下没有 php_fileinfo.dll，您可能需要重新下载或安装包含该扩展的 PHP 版本。
权限问题： 务必以管理员身份编辑 php.ini 文件，否则可能无法保存更改。
缓存： 有时 PHP 可能会缓存配置，重启计算机是最彻底的刷新方式，但通常重启 Web 服务或 PHP-FPM 即可。

总结

ext-fileinfo 扩展是现代 PHP 应用，特别是 Laravel 项目正常运行的基础。当遇到 Laravel 安装失败或 php artisan serve 无响应的问题时，首先检查 fileinfo 扩展是否启用是一个常见的且有效的排查方向。通过本文提供的步骤，您可以轻松解决此问题，确保您的 Laravel 开发环境能够顺利搭建和运行。正确的环境配置是高效开发的第一步。

以上就是解决 Laravel ext-fileinfo 缺失导致的安装与运行异常的详细内容，更多请关注php中文网其它相关文章！