本教程旨在解决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 FilesPHPv7.4php.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 FilesPHPv7.4extphp_fileinfo.dll）。如果不存在，您可能需要重新安装 PHP 或确保安装了完整的 PHP 发行版。
步骤三：保存并重启相关服务
修改 php.ini 文件后，必须保存更改并重启相关的服务，使配置生效。
在记事本中，点击“文件” -> “保存”。重启服务：如果您使用的是 XAMPP、WAMP 或 Laragon 等集成环境，请通过其控制面板重启 Apache 或 Nginx 服务。如果您是独立安装的 PHP，并且通过内置服务器 (php artisan serve) 运行，通常需要重启您的计算机，或者至少关闭所有当前的命令行窗口并重新打开，以确保 PHP 进程加载了新的配置。对于生产环境或更复杂的开发设置，可能需要重启 PHP-FPM 服务。
验证 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 开发环境能够顺利搭建和运行。正确的环境配置是高效开发的第一步。
以上就是解决 Laravel ext-fileinfo 缺失导致的安装与运行异常的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1328057.html
微信扫一扫 
支付宝扫一扫 
