Windows 10 PHP 缺少 fileinfo 解決方法

本文旨在解决Windows 10环境下，PHP项目中因缺少fileinfo扩展而导致composer install失败的问题。我们将指导你如何找到并启用php_fileinfo.dll扩展，以及解决修改php.ini文件时可能遇到的权限问题，确保你的PHP项目顺利运行。

在使用Composer安装PHP项目依赖时，可能会遇到类似以下错误：

Problem 1
- 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\v7.4\php.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.

这个错误表明你的PHP环境中缺少fileinfo扩展，需要手动启用。以下是详细步骤：

1. 找到正确的 php.ini 文件

首先，你需要确定PHP使用的php.ini文件。可以通过在命令行中运行以下命令来查找：

php --ini

该命令会输出PHP加载的配置文件路径。通常，会有两个路径：一个是Loaded Configuration File，另一个是Scan for additional .ini files in:(none)。我们需要关注Loaded Configuration File指向的文件。

2. 编辑 php.ini 文件

找到php.ini文件后，你需要以管理员权限打开它进行编辑。由于直接右键点击文件并选择“以管理员身份运行”可能无法生效，推荐使用以下方法：

• 使用代码编辑器以管理员权限打开： 比如，如果使用Visual Studio Code，可以在命令行中以管理员身份运行VS Code，然后通过VS Code打开php.ini文件。例如：

  code C:\Program Files\PHP\v7.4\php.ini

  (将 C:\Program Files\PHP\v7.4\php.ini 替换为你的实际路径)。

• 使用文本编辑器以管理员权限打开： 打开记事本或其他文本编辑器，然后选择“文件” -> “打开”，找到php.ini文件，并以管理员权限保存。

3. 启用 fileinfo 扩展

在打开的php.ini文件中，搜索extension=fileinfo。如果找到该行，但前面有分号（;），则表示该扩展被注释掉了。移除分号，取消注释该行，使其变为：

extension=fileinfo

如果没有找到该行，则手动添加该行到 [ExtensionList] 部分，确保文件路径正确。

4. 保存 php.ini 文件

保存修改后的php.ini文件。如果之前没有以管理员权限打开编辑器，保存时可能会遇到权限问题。

5. 重启Web服务器

修改php.ini文件后，必须重启Web服务器（如Apache、Nginx或内置的PHP服务器），使更改生效。

6. 验证 fileinfo 扩展是否已启用

可以通过以下两种方式验证 fileinfo 扩展是否已成功启用：

• 运行 php -m 命令： 在命令行中运行 php -m 命令，查看输出结果中是否包含 fileinfo。

• 创建 phpinfo() 页面： 创建一个包含以下代码的PHP文件（例如 info.php），并在浏览器中访问该文件：

  <?php
  phpinfo();
  ?>

  在phpinfo()页面中搜索 fileinfo，如果能找到相关信息，则表示该扩展已成功启用。

注意事项：

• 确保你编辑的是PHP命令行界面(CLI)和Web服务器都使用的php.ini文件。
• 如果你的PHP版本较低，可能需要使用 extension=php_fileinfo.dll 这样的写法。
• 如果仍然遇到问题，请检查PHP的错误日志，查看是否有关于fileinfo扩展加载失败的错误信息。

总结：

启用PHP的fileinfo扩展通常只需要取消注释或添加一行配置到php.ini文件中。关键在于找到正确的php.ini文件，并以管理员权限进行编辑和保存。完成这些步骤后，重启Web服务器，你的PHP项目应该就能正常运行了。