本教程旨在解决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 发行版。
步骤三：保存并重启相关服务
修改 php.ini 文件后，必须保存更改并重启相关的服务，使配置生效。
- 在记事本中，点击“文件” -> “保存”。
- 重启服务：
验证 fileinfo 扩展是否启用
配置更改并重启服务后，您可以通过以下方式验证 fileinfo 扩展是否已成功启用：
-
通过命令行：
打开命令行工具，输入 php -m。在输出的扩展列表中查找 fileinfo。如果存在，则表示已启用。
php -m
-
通过 phpinfo() 函数：
创建一个名为 info.php 的文件，内容如下：
将其放置在您的 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 开发环境能够顺利搭建和运行。正确的环境配置是高效开发的第一步。
