number_format()最直接但参数顺序易错：首参为数字，次参为小数位数；多语言场景宜用numberfmt_create()配合intl扩展；高频整数格式化可手写字符串拼接提升性能。
用 number_format() 最直接，但要注意参数顺序
PHP 原生函数 number_format() 就是干这事的，不用装包、不依赖扩展。但它有四个参数，最容易错的是前两个位置：第一个是数字本身，第二个是小数位数——很多人误以为第二个是千分位符号。
常见错误现象：number_format(1234567, ',') 报 Warning：第二个参数必须是 int，结果直接崩；或者写成 number_format(1234567, 0, '.', ',') 却发现小数点和逗号反了，输出变成 1,234,567.（末尾多一个点）。
- 要纯整数千分位（无小数）：用
number_format(1234567, 0, '', ',') - 要保留两位小数且用英文习惯：用
number_format(1234567.89, 2, '.', ',') - 如果数字来自用户输入或数据库，先
(int)或intval()转下型，避免字符串传入导致返回false
遇到 locale 场景别硬套 number_format()
如果你在做多语言站，比如法语用户期望 1 234 567（空格分隔）、德语用 1.234.567,89（逗号作小数点），这时候硬调 number_format() 参数容易翻车——它不读系统 locale，所有符号都得手动塞。
更稳妥的做法是用 numberfmt_create()（intl 扩展）：
立即学习“PHP免费学习笔记（深入）”；
if (extension_loaded('intl')) {
$fmt = numberfmt_create('fr_FR', NumberFormatter::DECIMAL);
echo numberfmt_format($fmt, 1234567); // 输出：1 234 567
}注意：intl 在部分共享主机上默认不启用，运行前先 var_dump(extension_loaded('intl')); 确认；没开的话，老实用 number_format() 配合 str_replace() 临时凑合，别强行 fallback 到 locale 函数。
性能敏感场景下，字符串拼接比 number_format() 快一点
如果是在高频循环里格式化大量整数（比如导出报表、实时统计），number_format() 内部有类型检查和字符串构造开销，实测比手写逻辑慢 15%–20%。
简单整数（正数、无小数、确定是 int）可考虑自己切段：
$n = 1234567;
$str = (string)$n;
$len = strlen($str);
$result = '';
for ($i = 0; $i < $len; $i++) {
if ($i > 0 && ($len - $i) % 3 === 0) $result .= ',';
$result .= $str[$i];
}但这只适合受控环境：必须确保输入是纯正整数、长度适中（
从数据库取数后直接格式化容易漏掉 NULL 和空字符串
常见场景：MySQL 字段是 INT NULL，查出来可能是 null 或 ''，直接喂给 number_format() 会警告并返回 false，前端显示空白或 0，问题难定位。
- 加一层保护：
is_numeric($val) ? number_format((float)$val, 0, '', ',') : '' - 如果字段定义为
NOT NULL DEFAULT 0，那就放心用；否则一定检查原始值类型，别只看文档说“是整型”就跳过验证 - ORM 如 Laravel Eloquent 的
casts里设'price' => 'integer'，对 NULL 不自动转 0，仍需业务层兜底
千分位看着简单，真正上线后出问题，八成卡在数据源脏、类型不稳、locale 混用这三块。盯住输入，比调对函数更重要。
