
本教程旨在解决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 的文件,内容如下:
<?phpphpinfo();?>登录后复制
将其放置在您的 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中文网其它相关文章!



