如何在 Windows 10 中安装并启用 PHP fileinfo 扩展-php教程-PHP中文网

如何在 Windows 10 中安装并启用 PHP fileinfo 扩展

霞舞

发布： 2025-09-24 20:22:03

原创

239人浏览过

如何在 windows 10 中安装并启用 php fileinfo 扩展

本文旨在解决在 Windows 10 环境下，由于 PHP 缺少 fileinfo 扩展而导致 Composer 安装失败的问题。我们将详细介绍如何找到正确的 php.ini 文件，以及如何修改该文件以启用 php_fileinfo.dll 扩展，从而解决依赖于该扩展的 Composer 包安装问题。

在 Windows 10 系统中，启用 PHP 的 fileinfo 扩展通常涉及以下几个步骤：找到正确的 php.ini 文件，编辑该文件，添加或取消注释 extension=php_fileinfo.dll，并重启 Web 服务器或 PHP-FPM。下面将详细介绍这些步骤。

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

当遇到 Composer 提示缺少 fileinfo 扩展时，首先需要确定 PHP 使用的 php.ini 文件。Composer 错误信息通常会给出 php.ini 文件的路径，例如：

To enable extensions, verify that they are enabled in your .ini files:
- C:\Program Files\PHP\v7.4\php.ini

登录后复制

如果没有明确的路径，可以使用命令行工具来查找：

立即学习“PHP免费学习笔记（深入）”；

php --ini

登录后复制

该命令会输出 PHP 使用的配置文件路径。需要注意的是，命令行环境和 Web 服务器环境可能使用不同的 php.ini 文件，因此需要根据实际情况选择。

2. 编辑 php.ini 文件

找到 php.ini 文件后，需要以管理员权限打开并编辑它。由于直接右键以管理员身份打开文件可能不可行，可以使用以下方法：

使用代码编辑器以管理员身份打开： 例如，使用 Visual Studio Code，可以通过命令行以管理员身份启动 VS Code，然后打开 php.ini 文件。
```
code C:\Program Files\PHP\v7.4\php.ini
```
登录后复制
(将 C:\Program Files\PHP\v7.4\php.ini 替换为实际的 php.ini 路径)

如果提示权限问题，请确保以管理员身份运行命令行终端。
复制文件到其他位置进行编辑： 如果直接修改 php.ini 文件遇到权限问题，可以将文件复制到桌面或其他位置，进行编辑后再复制回原位置。需要注意的是，复制回原位置时也需要管理员权限。

如知AI笔记
如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

打开 php.ini 文件后，搜索 extension=php_fileinfo.dll 或 extension=fileinfo。

如果找到该行，但被注释了（行首有 ;），则取消注释： 移除行首的 ; 符号。
```
;extension=php_fileinfo.dll  ; 原始状态
extension=php_fileinfo.dll  ; 修改后的状态
```
登录后复制
如果未找到该行，则手动添加： 在 [ExtensionList] 部分或其他扩展列表区域添加 extension=php_fileinfo.dll。
```
[ExtensionList]
extension=php_mysqli.dll
extension=php_mbstring.dll
; ... 其他扩展 ...
extension=php_fileinfo.dll  ; 添加的行
```
登录后复制

保存修改后的 php.ini 文件。

3. 重启 Web 服务器或 PHP-FPM

修改 php.ini 文件后，需要重启 Web 服务器（例如 Apache 或 Nginx）或 PHP-FPM 才能使更改生效。

Apache: 重启 Apache 服务器。
Nginx + PHP-FPM: 重启 PHP-FPM 服务。

具体重启方法取决于服务器的配置和操作系统。在 Windows 上，通常可以通过服务管理器来重启这些服务。

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

重启服务器后，可以通过以下方法验证 fileinfo 扩展是否已成功启用：

使用 phpinfo() 函数： 创建一个包含 phpinfo() 函数的 PHP 文件，然后在浏览器中访问该文件。在输出的页面中搜索 "fileinfo"，如果找到相关信息，则表示扩展已成功启用。
```
<?php
phpinfo();
?>
```
登录后复制
使用命令行： 在命令行中运行 php -m 命令，查看已加载的扩展列表。如果列表中包含 "fileinfo"，则表示扩展已成功启用。
```
php -m | findstr fileinfo
```
登录后复制

注意事项

PHP 版本： 确保使用的 php.ini 文件与当前 PHP 版本对应。
权限问题： 在编辑 php.ini 文件时，务必以管理员身份进行操作，以避免权限问题。
重启服务： 修改 php.ini 文件后，必须重启 Web 服务器或 PHP-FPM 才能使更改生效。
DLL 文件： 在极少数情况下，如果缺少 php_fileinfo.dll 文件，需要从 PHP 官方网站下载对应版本的 PHP 包，并将该文件复制到 PHP 的 ext 目录下。