本文旨在解决初次使用 laravel 时，因 php `fileinfo` 扩展缺失而导致的 composer 安装失败及 `php artisan serve` 命令无响应的问题。教程将详细指导如何在 windows 系统下通过编辑 `php.ini` 文件来启用 `fileinfo` 扩展，确保 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[...].
这个错误明确指出，Laravel 框架的某些依赖（例如 league/flysystem）需要 PHP 的 fileinfo 扩展。如果此扩展未启用，Composer 将无法完成依赖的解析和安装。即使项目结构看似创建成功，后续运行 php artisan serve 命令也可能没有任何反应，因为 PHP 环境不完整，无法正确启动内置服务器。
解决方案：启用 PHP fileinfo 扩展
解决此问题的核心在于启用 PHP 配置中的 fileinfo 扩展。这通常涉及编辑 PHP 的配置文件 php.ini。以下是在 windows 系统下操作的详细步骤：
-
以管理员身份打开文本编辑器：
立即学习“PHP免费学习笔记（深入）”；
- 点击 Windows 任务栏左下角的“开始”按钮。
- 在搜索框中输入 Notepad（记事本）或您偏好的文本编辑器（如 VS Code、sublime Text 等）。
- 在搜索结果中，右键点击 Notepad，然后选择“以管理员身份运行”。这是至关重要的一步，因为 php.ini 文件通常位于系统目录中，需要管理员权限才能修改并保存。
-
定位并打开 php.ini 文件：
- 在以管理员身份运行的文本编辑器中，点击“文件”菜单，选择“打开”。
- 在弹出的文件选择对话框中，您需要找到您的 php.ini 文件。php.ini 文件的位置取决于您的 PHP 安装方式和版本。常见路径包括：
- C:phpphp.ini
- C:Program FilesPHPvX.Xphp.ini (其中 vX.X 是您的 PHP 版本，例如 v7.4 或 v8.1)
- 如果您不确定 php.ini 的具体位置，可以在命令提示符中运行 php –ini 命令，它会显示 php.ini 的加载路径。
- 将 php.ini 的完整路径粘贴到文件选择对话框的地址栏中，然后按回车键或点击“打开”。
-
编辑 php.ini 文件：
- 在打开的 php.ini 文件中，查找包含 extension=php_fileinfo.dll 的行。
- 如果这行前面有一个分号 ;（表示该行被注释掉），请删除这个分号，使其变为 extension=php_fileinfo.dll。
- 如果文件中找不到这行，您可以在其他 extension= 语句的下方，或文件的末尾，添加 extension=php_fileinfo.dll。
示例：
; Some other extensions... ;extension=php_gd.dll extension=php_fileinfo.dll ; 确保这一行没有分号 ;extension=php_intl.dll
-
保存更改：
- 完成编辑后，点击文本编辑器的“文件”菜单，选择“保存”。
-
重启系统或相关服务：
验证解决方案
完成上述步骤并重启计算机后，您可以再次尝试以下操作来验证问题是否已解决：
-
重新创建 Laravel 项目（如果之前失败）：
composer create-project laravel/laravel your-project-name
如果项目能够顺利创建，没有 ext-fileinfo 错误，则说明 fileinfo 扩展已成功启用。
-
启动 Laravel 内置服务器：
- 进入您的 Laravel 项目目录：
cd your-project-name
- 运行内置服务器命令：
php artisan serve
- 如果服务器成功启动并显示类似 Laravel development server started: http://127.0.0.1:8000 的信息，并且您可以在浏览器中访问该地址，则表示问题已彻底解决。
- 进入您的 Laravel 项目目录：
注意事项与总结
- PHP 版本兼容性： 确保您使用的 php_fileinfo.dll 扩展版本与您的 PHP 版本兼容。通常，它会与您的 PHP 安装包一起提供。
- 多个 php.ini 文件： 有时系统上可能存在多个 php.ini 文件（例如，一个用于 CLI，一个用于 Web 服务器）。请确保您修改的是当前 PHP 环境正在加载的 php.ini 文件。使用 php –ini 可以帮助您确认。
- 错误日志： 如果问题依然存在，检查 PHP 的错误日志（通常在 php.ini 中配置 error_log 路径）可能会提供更多线索。
启用 PHP 的 fileinfo 扩展是 Laravel 项目顺利运行的基础要求之一。通过本文的详细步骤，您可以有效地解决因该扩展缺失而导致的安装和运行问题，为您的 Laravel 开发之旅扫清障碍。