Windows 11 下如何开启 PHP Intl 扩展？完整步骤与常见问题解答

1. 了解 PHP Intl 扩展及其作用

PHP Intl 扩展 提供了多语言区域设置、格式化货币与数字、日期与时间、排序等国际化功能，帮助应用在不同语言环境下正确处理本地化需求。

在 Windows 11 环境中，Intl 依赖 ICU 数据，因此选择与 PHP 构建匹配的 ICU 库版本非常重要，这会直接影响扩展的兼容性与稳定性。

要快速确认扩展是否已加载，可以在命令行执行以下命令来验证：

php -m | findstr /i intl

2. Windows 11 环境下的前提检查

2.1 确认 PHP 安装路径与版本信息

在开始之前，先确认你正在使用的 PHP 安装路径以及版本信息，避免在不同环境（CLI、Web 服务器、IDE 运行时）之间产生配置冲突。你可以通过以下命令快速定位并查看版本信息：Loaded Configuration File 与 PHP 版本。

执行命令以获取安装路径、版本信息和配置文件位置：

php --ini
php -v

2.2 确认扩展目录与权限

PHP 的扩展文件通常位于 ext 目录下，请确保 extension_dir 指向正确的 ext 目录，并且服务器进程对该目录有读取权限。

在 php.ini 中，扩展目录通常配置为：

extension_dir = "ext"

3. 启用 Intl 扩展的完整步骤

3.1 找到并编辑 php.ini

要启用 Intl 扩展，需要修改正在使用的 php.ini 文件。先通过命令确定配置文件的位置，然后用文本编辑器打开：确保你编辑的是正在使用的配置文件，避免修改错了环境导致扩展未生效。

打开 php.ini 的示例命令（以 Windows 为例）是：

notepad "C:\path\to\php\php.ini"

3.2 启用扩展并确保依赖

在 php.ini 中取消对 Intl 扩展的注释，并确保扩展目录正确设置。如果你的文件中有以下两行，请按如下方式修改：取消注释并保持扩展在 ext 目录，以及确保扩展目录正确。

示例修改：

; extension=php_intl.dll
extension=php_intl.dll; 确认扩展目录
extension_dir = "ext"

如果运行时仍提示找不到依赖项，可能需要手动拷贝 ICU 相关动态连接库到系统路径，例如 icudt*.dll、icu*.dll 等。请确保它们与 PHP 构建版本兼容。执行以下命令用于快速验证扩展是否已在模块列表中加载：

php -m | findstr /i intl

3.3 重启服务并验证

修改配置后，需要重启 Web 服务器或 PHP 服务以使改动生效。若使用 IIS，请运行：iisreset；若使用 Apache，请执行以下两条命令完成重启：net stop 和 net start。

重启后，再次验证 Intl 是否已启用：

php -m | findstr /i intl
php -i | findstr /i "intl"

php -v

4. 常见问题与故障排除

4.1 为什么会出现找不到 php_intl.dll？

常见原因包括 php_intl.dll 文件缺失、扩展目录不对、架构不匹配，以及未按要求拷贝 ICU 相关 DLL 造成的依赖缺失。请先确认 ext 目录中确实存在 php_intl.dll；如不存在，需重新从 PHP 官方发行包的 ext 目录获取适配当前 PHP 版本的 dll。

你可以快速检查文件是否存在：

dir "C:\path\to\php\ext\php_intl.dll"

4.2 如何处理 icu 依赖

Intl 扩展需要 ICU 的运行时 DLL，若系统提示找不到 icu*.dll，需将 ICU DLL 拷贝到系统路径或与 PHP 相同目录下，确保可被加载。请确认 ICU 版本与 PHP 构建版本匹配，常见做法是将 icudt*.dll、icuuc*.dll、icuin*.dll 放入系统目录或 PHP 目录并添加到 PATH。

示例检查 ICU 文件夹是否存在并包含需要的 DLL：

dir "C:\path\to\php\icu"

4.3 如何确认 Intl 已启用

确认方法有多种，最直接的就是检查扩展列表和 Intl 的信息。执行以下命令可快速验证：

查看扩展列表中是否包含 intl：

php -m | findstr /i intl

查看扩展信息中是否有 Intl 配置：

php -i | findstr /i "intl"