本文旨在解决初次使用 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.iniC: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.dllextension=php_fileinfo.dll ; 确保这一行没有分号;extension=php_intl.dll
保存更改：
完成编辑后，点击文本编辑器的“文件”菜单，选择“保存”。
重启系统或相关服务：
为了使 php.ini 的更改生效，您需要重启您的计算机。这是最彻底且最推荐的方式，以确保所有依赖 PHP 的进程（包括命令行 PHP 和 php artisan serve）都能加载新的配置。如果您是在 Web 服务器环境（如 Apache、Nginx 配合 PHP-FPM）下使用 PHP，通常只需要重启相应的 Web 服务器和 PHP-FPM 服务即可，但对于初学者和命令行工具，重启计算机更为稳妥。
验证解决方案
完成上述步骤并重启计算机后，您可以再次尝试以下操作来验证问题是否已解决：
重新创建 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 的信息，并且您可以在浏览器中访问该地址，则表示问题已彻底解决。
注意事项与总结
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 开发之旅扫清障碍。
以上就是解决 Laravel 项目中 PHP fileinfo 扩展缺失导致的问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1327947.html
微信扫一扫 
支付宝扫一扫 
![Go语言接口与切片：如何识别和操作[]interface{}](https://cdn.chuangxiangniao.com/www/2025/12/176369856569294-1.jpg?imageMogr2/crop/480x300/gravity/center)
