本教程旨在解决 codeigniter 框架运行时提示 `intl` 扩展缺失的常见问题。文章将详细指导用户如何定位正确的 `php.ini`配置文件 ，正确启用 `intl` 扩展，并强调重启 web 服务器的重要性。通过系统性的排查步骤，确保 `intl` 扩展被php 正确加载，从而消除 codeigniter 的启动障碍。
引言：CodeIgniter 对 intl 扩展的需求
CodeIgniter 4 及更高版本对国际化（Internationalization, I18N）和本地化（Localization, L10N）功能有内置支持，这依赖于 PHP 的 intl（Internationalization Functions）扩展。当 intl 扩展未被正确安装或加载时，CodeIgniter 框架在启动时会抛出如下错误：
此错误通常发生在 SYSTEMPATH/CodeIgniter.php 文件的 resolvePlatformExtensions()方法中，表明框架在初始化阶段未能检测到所需的 intl 扩展。解决此问题的关键在于正确配置 PHP 环境，确保 intl 扩展能够被 PHP 解释器加载。
定位正确的 php.ini 文件
许多用户在尝试解决此问题时，可能会修改了错误的 php.ini 文件。这是因为系统上可能存在多个 PHP 版本，或者 CLI（命令行界面）和 Web 服务器（如apache、nginx）使用的 php.ini 路径不同。要确保修改生效，必须找到 Web 服务器正在使用的 php.ini 文件。
方法一：通过 phpinfo()函数查找
这是最可靠的方法。
立即学习“PHP 免费学习笔记（深入）”；
-
在您的 Web 服务器根目录下创建一个名为 info.php 的文件（或任何其他名称）。
-
在该文件中添加以下内容：
<?php phpinfo(); ?> -
在输出页面中，查找名为“Loaded Configuration File”的条目。它将显示当前 PHP 解释器正在加载的 php.ini 文件的完整路径。
方法二：通过命令行查找
php --ini此命令会列出 PHP 解释器正在使用的 php.ini 文件路径，包括主 配置文件 和额外的配置文件。请注意，此方法显示的是 CLI 使用的 php.ini，可能与 Web 服务器使用的不同。如果 Web 服务器和 CLI 使用不同的 PHP 版本或配置，请优先使用 phpinfo()方法。
启用 intl 扩展
一旦您确定了正确的 php.ini 文件路径，接下来的步骤是编辑该文件以启用 intl 扩展。
-
打开 php.ini 文件： 使用文本编辑器（如 nano, vi, VS Code 等）打开您在上一节中找到的 php.ini 文件。例如：
sudo nano /etc/php/7.4/apache2/php.ini（路径根据您的系统和 PHP 版本而异）
-
查找并取消注释 intl 扩展： 在 php.ini 文件中，搜索包含 intl 的行。您可能会找到类似以下两种形式的行：
在这些行的前面，如果存在分号（;），则表示该行被注释掉了，即扩展未被加载。您需要将分号移除，使其变为：
- 对于 Linux/Unix 系统：
extension=intl - 对于 Windows 系统：
extension=php_intl.dll
确保在文件中只启用一次 intl 扩展。
- 对于 Linux/Unix 系统：
-
保存并关闭文件： 保存您对 php.ini 文件的修改。
重启 Web 服务器或 PHP-FPM 服务
对 php.ini 文件的任何修改都不会立即生效，除非您重启 Web 服务器或 PHP-FPM 服务。这是至关重要的一步，常常被新手忽略。
根据您使用的 Web 服务器和 PHP 运行方式，重启命令会有所不同：
-
对于 Apache Web 服务器：
sudo service apache2 restart # 或者 sudo systemctl restart apache2 -
对于 Nginx + PHP-FPM： 您需要重启 PHP-FPM 服务。请根据您的 PHP 版本调整命令：
sudo service php7.4-fpm restart # 或者 sudo systemctl restart php7.4-fpm # 如果是 PHP 8.x sudo systemctl restart php8.0-fpm（请将 7.4 替换为您的实际 PHP 版本）
验证 intl 扩展是否已加载
在重启服务后，您应该再次验证 intl 扩展是否已被 PHP 正确加载。
-
通过 phpinfo()验证： 再次访问您之前创建的 info.php 文件（http://localhost/info.php）。在页面中搜索“intl”。如果成功加载，您会看到一个名为“intl”的模块配置块，其中包含 intl 的版本信息和其他相关设置。
-
通过命令行验证： 在终端中执行以下命令：
php -m | grep intl如果 intl 扩展已加载，此命令将输出 intl。
常见问题与高级排查
如果按照上述步骤操作后，问题依然存在，请考虑以下排查点：
- 扩展路径问题（extension_dir）： 确保 php.ini 中的 extension_dir 配置项指向了正确的 PHP 扩展文件存放目录。例如，在 Windows 上，php_intl.dll 文件必须位于 extension_dir 指定的目录下。在 Linux 上，intl.so 文件也应位于该目录。
- 多个 PHP 版本冲突： 确认您的 Web 服务器正在使用您修改 php.ini 文件的那个 PHP 版本。有时系统会安装多个 PHP 版本，而 Web 服务器可能配置为使用不同的版本。
- 权限问题： 确保 Web 服务器用户（如 www-data 或nginx）有权限读取 php.ini 文件以及 extension_dir 目录下的扩展文件。
- Windows 特定： 在 Windows 上，php_intl.dll 可能依赖于 icu*.dll 文件（如 icuuc6x.dll, icudt6x.dll 等）。这些 DLL 文件通常位于 PHP 安装目录的根目录或 ext 子目录中。确保它们存在且可被 PHP 访问。
总结
解决 CodeIgniter 框架中 intl 扩展缺失的问题，核心在于以下几个关键步骤：
- 定位正确的 php.ini 文件 ：使用 phpinfo() 是最佳实践。
- 启用 intl 扩展：在 php.ini 中找到并取消注释
extension=intl（或extension=php_intl.dll）。 - 重启 Web 服务器或 PHP-FPM 服务：确保配置更改生效。
- 验证 intl 加载状态 ：再次通过 phpinfo() 或命令行确认。
通过遵循这些详细步骤，您应该能够成功解决 CodeIgniter 框架的 intl 扩展缺失问题，使您的应用程序正常运行。
