本教程详细介绍了在使用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文件。
在文件中查找以下行：
;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中文网其它相关文章！