Laravel项目初始化错误：ext-fileinfo 扩展启用指南-php教程-PHP中文网

Laravel项目初始化错误：ext-fileinfo 扩展启用指南

霞舞

发布： 2025-09-19 13:19:27

原创

448人浏览过

Laravel项目初始化错误：ext-fileinfo 扩展启用指南

本教程详细介绍了在使用Composer创建Laravel项目时，因PHP fileinfo 扩展缺失而导致项目初始化失败及vendor目录丢失的问题。文章将指导用户如何通过修改php.ini文件启用fileinfo扩展，并确保Laravel项目能够成功创建，避免常见的环境配置障碍。

问题描述与错误分析

在使用composer命令 composer create-project laravel/laravel new-project 创建新的laravel项目时，开发者可能会遇到项目初始化失败的情况，尤其是在项目根目录缺少vendor文件夹时。通常，此问题伴随着如下所示的错误信息：

composer create-project laravel/laravel new-project
    - laravel/framework[v8.65.0, ..., 8.x-dev] require league/flysystem ^1.1 -> satisfiable by league/flysystem[1.1.0, ..., 1.x-dev].
    - league/flysystem[1.1.0, ..., 1.x-dev] 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[v8.65.0, ..., 8.x-dev].

To enable extensions, verify that they are enabled in your .ini files:
    - C:\Program Files\php-8.0.12\php.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.

登录后复制

此错误信息清晰地指出，league/flysystem（Laravel框架的一个依赖项）需要PHP的ext-fileinfo扩展。由于该扩展在系统中缺失或未启用，Composer无法完成依赖项的安装，导致Laravel项目创建中断，vendor目录自然也无法生成。

解决方案：启用 fileinfo 扩展

解决此问题的核心在于启用PHP的fileinfo扩展。这通常通过编辑PHP的配置文件php.ini来完成。

1. 定位正确的 php.ini 文件

PHP在不同的运行模式下（如CLI命令行模式、FPM模式、Apache模块模式等）可能会使用不同的php.ini文件。由于我们是通过命令行运行composer create-project，因此需要确保修改的是CLI模式下PHP使用的php.ini。

在终端或命令行中执行以下命令，可以查看到PHP当前加载的php.ini文件路径：

php --ini

登录后复制

输出通常会包含类似以下的信息，其中Loaded Configuration File即为当前使用的php.ini文件：

Configuration File (php.ini) Path: C:\WINDOWS
Loaded Configuration File:         C:\Program Files\php-8.0.12\php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed:      (none)

登录后复制

根据上述输出，我们需要修改的文件是 C:\Program Files\php-8.0.12\php.ini。

2. 编辑 php.ini 文件

使用任何文本编辑器（如Notepad++、VS Code、Sublime Text等）打开在第一步中定位到的php.ini文件。

在文件中查找以下行：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

;extension=fileinfo

登录后复制

这行前面的分号（;）表示该扩展被注释掉了，即未启用。要启用fileinfo扩展，只需移除该行开头的分号即可：

extension=fileinfo

登录后复制

确保保存对php.ini文件的修改。

3. 验证 fileinfo 扩展是否启用

保存php.ini文件后，可以在命令行中再次验证fileinfo扩展是否已成功启用。执行以下命令：

php -m | findstr fileinfo
# 或在Linux/macOS下使用
# php -m | grep fileinfo

登录后复制

如果fileinfo扩展已成功启用，命令会输出fileinfo。

4. 重新创建 Laravel 项目

在确认fileinfo扩展已启用后，可以尝试重新创建Laravel项目。

composer create-project laravel/laravel new-project

登录后复制

此时，Composer应该能够顺利下载并安装所有依赖项，并在new-project目录下生成完整的项目结构，包括vendor文件夹。

注意事项

权限问题： 确保您有足够的权限修改php.ini文件。如果遇到保存失败，请尝试以管理员身份运行文本编辑器。
多个PHP版本： 如果您的系统上安装了多个PHP版本，请务必确保修改的是Composer命令所使用的PHP版本的php.ini文件。php --ini命令是确认这一点的最佳方式。
Web服务器重启（如果适用）： 虽然对于CLI模式下的Composer操作，通常无需重启Web服务器，但如果您的开发环境涉及到Apache或Nginx等Web服务器，并且您希望fileinfo扩展也能在Web环境下生效，那么在修改php.ini后，建议重启相应的Web服务器。
Composer缓存： 极少数情况下，Composer的缓存可能导致问题。如果上述步骤未能解决问题，可以尝试清除Composer缓存：composer clear-cache。

总结

Laravel项目创建失败，特别是因ext-fileinfo扩展缺失导致的vendor目录不完整问题，是一个常见的环境配置障碍。通过精确地定位PHP的php.ini文件，并取消注释extension=fileinfo行，可以迅速解决此问题。理解错误信息、遵循正确的排查步骤，是高效解决开发环境配置问题的关键。确保PHP环境满足框架的所有依赖要求，是项目顺利启动和运行的基础。

以上就是Laravel项目初始化错误：ext-fileinfo 扩展启用指南的详细内容，更多请关注php中文网其它相关文章！