PHP nl_langinfo() 函数（长文讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，国际化（i18n）和本地化（l10n）是构建多语言应用的核心能力。无论是显示日期、货币符号，还是处理不同地区的格式规则，开发者都需要一套统一的方法来适配用户所在的语言环境。此时，nl_langinfo() 函数便成为了一个不可或缺的工具。本文将从基础到实践，系统讲解这一函数的用法、应用场景及进阶技巧，帮助开发者快速掌握其核心价值。

一、函数基础：语法与核心功能

1.1 函数定义与语法

nl_langinfo() 是 PHP 提供的用于获取本地化信息的函数，其语法如下：

string nl_langinfo ( int $item )  

该函数接受一个表示本地化信息类型的整数参数 $item，并返回对应的语言环境字符串。

关键参数 $item 的常见取值

PHP 定义了多个常量，用于指定需要查询的本地化信息类型。以下是部分常用参数及其含义：

1.2 函数前置条件：设置语言环境

nl_langinfo() 的返回值依赖于当前的本地化设置。若未显式指定语言环境，函数将使用系统默认的 locale。因此，在使用前通常需要调用 setlocale() 函数来设置目标区域：

// 设置语言环境为美国英语  
setlocale(LC_ALL, 'en_US.UTF-8');  

// 获取日期格式字符串  
$format = nl_langinfo(DATE_FMT);  
echo $format; // 输出: %A %B %d %Y  

二、核心应用场景与案例

2.1 场景一：日期与时间格式适配

不同地区的日期和时间显示规则差异显著。例如，美国习惯 "MM/DD/YYYY"，而欧洲常用 "DD/MM/YYYY"。通过 nl_langinfo() 可动态获取目标 locale 的格式：

// 设置为法国本地化  
setlocale(LC_TIME, 'fr_FR.UTF-8');  

// 获取日期格式  
$dateFormat = nl_langinfo(DATE_FMT); // 输出: %d %B %Y  
// 使用该格式输出当前日期  
echo strftime($dateFormat); // 输出: 20 octobre 2023  

比喻说明

想象 nl_langinfo() 是一位“本地化向导”，它能根据你选择的地区（如法国、日本），告诉你“这里的日期应该怎么写”。开发者只需遵循它的指引，即可生成符合当地习惯的输出。

2.2 场景二：货币与数字格式处理

货币符号（如美元 $、欧元 €）和数字分隔符（如小数点 . 或逗号 ,）也需本地化适配。例如：

// 设置为德国本地化  
setlocale(LC_MONETARY, 'de_DE.UTF-8');  

// 获取货币符号  
$currencySymbol = nl_langinfo(CRNCY_SYMBOL); // 输出: €  
// 获取小数点符号  
$decimalPoint = nl_langinfo(RADIXCHAR);      // 输出: ,  

// 输出价格  
echo "价格: " . $currencySymbol . "1234" . $decimalPoint . "56"; // 输出: 价格: €1234,56  

2.3 场景三：多语言星期与月份名称

当开发日历或日程应用时，动态显示星期和月份名称是常见需求：

// 设置为西班牙本地化  
setlocale(LC_TIME, 'es_ES.UTF-8');  

// 获取星期名称（简写）  
$weekdays = [  
    nl_langinfo(ABDAY_1), // Domingo  
    nl_langinfo(ABDAY_2), // Lunes  
    // ...  
];  

// 获取月份名称  
$months = [  
    nl_langinfo(MON_1), // Enero  
    nl_langinfo(MON_2), // Febrero  
    // ...  
];  

三、进阶技巧与注意事项

3.1 动态切换语言环境

在多语言应用中，可通过用户选择动态切换 locale：

// 用户选择的语言  
$selectedLocale = 'ja_JP.UTF-8';  

// 设置 locale 并验证是否成功  
if (setlocale(LC_ALL, $selectedLocale) === false) {  
    die("无法设置语言环境");  
}  

// 获取本地化信息  
echo nl_langinfo(DATE_FMT); // 输出: %Y年%m月%d日  

3.2 处理 locale 支持性问题

并非所有系统都安装了所有 locale。可通过 locale -a（Linux/macOS）或 ls /usr/share/i18n/locales 检查可用 locale。若目标 locale 不存在，setlocale() 将返回 false。

3.3 与 strftime() 的协同使用

nl_langinfo() 返回的格式字符串通常需要与 strftime() 结合使用：

// 获取并应用日期格式  
$format = nl_langinfo(D_T_FMT);  
echo strftime($format); // 输出符合当前 locale 的完整日期时间  

四、完整案例：构建多语言日期显示模块

4.1 需求描述

设计一个 PHP 类，根据用户选择的地区动态显示日期、时间及货币格式。

4.2 代码实现

class LocalizationHelper {  
    private $locale;  

    public function __construct(string $locale) {  
        // 设置 locale 并验证  
        if (setlocale(LC_ALL, $locale) === false) {  
            throw new Exception("无效的语言环境: $locale");  
        }  
        $this->locale = $locale;  
    }  

    public function getFormattedDate() {  
        return strftime(nl_langinfo(DATE_FMT));  
    }  

    public function getCurrencySymbol() {  
        return nl_langinfo(CRNCY_SYMBOL);  
    }  

    public function getDecimalSeparator() {  
        return nl_langinfo(RADIXCHAR);  
    }  
}  

// 使用示例  
$helper = new LocalizationHelper('fr_FR.UTF-8');  
echo "Date: " . $helper->getFormattedDate() . "\n";  
echo "Currency: " . $helper->getCurrencySymbol() . "\n";  
echo "Decimal Separator: " . $helper->getDecimalSeparator();  

4.3 输出结果（以法国 locale 为例）

Date: 20 octobre 2023  
Currency: €  
Decimal Separator: ,  

结论

PHP nl_langinfo() 函数通过提供灵活的本地化信息查询能力，成为构建国际化应用的实用工具。从基础语法到复杂场景，开发者可通过它轻松适配不同地区的日期、货币及格式规则。随着项目需求的增长，合理结合 setlocale() 和 strftime()，更可构建出高度本地化的高质量应用。掌握这一函数，不仅能提升代码的可维护性，更能为用户提供更贴近其习惯的使用体验。

提示：若遇到 locale 未安装的问题，可通过系统命令（如 sudo locale-gen fr_FR.UTF-8）生成所需语言环境。