number_format在php 8.2中行为稳定，但需注意输入必须为数字、参数组合仅支持1/2/4个、小数位不能为负、不可在双引号插值中直接调用。
核心规则：输入必须是数字，不是字符串
即使传入像 "1234.56" 这样的纯数字字符串，PHP 也会隐式转为 float；但一旦含非数字字符（如 "$1,234.56" 或 "1.234,56"），就会在第一个非法字符处截断，变成 1 或 0，结果完全错误。
✅ 正确做法：
- 先清理原始字符串：用 filter_var($str, FILTER_SANITIZE_NUMBER_FLOAT) 去掉符号、空格、逗号等
- 再显式转换：(float)$cleaned 或 floatval($cleaned)
- 最后检查：is_finite($num) && !is_nan($num)，避免无效数参与格式化
参数组合：只支持 1、2 或 4 个参数，不能是 3 个
常见误写：number_format($n, ',', '.') ——这会把逗号当小数位数（转成整数是 0），实际调用的是 number_format($n, 0, ',', '.')，千分位和小数点全反了。
✅ 推荐写法（明确、不易错）：
-
保留两位小数，英文习惯：
number_format($n, 2, '.', ',')→ 1,234,567.89 -
法语/德语习惯（逗号作小数点，空格作千分位）：
number_format($n, 2, ',', ' ')→ 1 234 567,89 -
纯数字无千分位（如用于计算字段或 API 输出）：
number_format($n, 2, '.', '')→ 1234567.89
小数位控制：支持负值（PHP 8.3+ 新增），PHP 8.2 不支持
⚠️ 注意：PHP 8.2 中 $decimals 参数必须 ≥ 0。若传入负数（如 -2），会被当作 0 处理，不会报错但无预期效果（即不四舍五入到千位）。需要类似功能，得自行用 round($n, -2) 预处理再传入。
嵌入字符串时：不能在双引号中直接调用函数
❌ 错误："Price: {$number_format($price, 2)}" —— 语法错误，PHP 不允许插值中执行函数调用。
✅ 正确方式：先格式化，再拼接
$price_fmt = number_format($price, 2, '.', ',');echo "Price: $price_fmt";- 或用于 HTML：
<td>{$price_fmt}</td>（在 heredoc 或已定义变量前提下）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
