PHP sprintf()：格式化字符串、补零与保留小数

sprintf() 根据一个格式和一组值拼出一个字符串并返回：格式里的每个 % 占位符依次被下一个值替换。sprintf('%s is %d years old', 'Ada', 36) 返回 "Ada is 36 years old"。printf() 接收同样的参数，但它直接打印结果，而不是返回结果。

<?php
$name = 'Ada';
$age = 36;
$price = 4.5;

$line = sprintf('%s is %d years old', $name, $age);
echo $line, "\n";

// Two decimals, always
echo sprintf('Total: %.2f EUR', $price), "\n";

// printf prints directly
printf("Order #%05d for %s\n", 42, $name);

占位符按从左到右的顺序依次填入。%.2f 总是显示两位小数（4.50，而不是 4.5），%05d 用零把数字补足到五位。

格式说明符

一个占位符由 %、可选的修饰符和一个表示类型的字母组成：

改一下下面的值，再运行一次：

<?php
echo sprintf('%s', 'PHP'), "\n";
echo sprintf('%d', 42.9), "\n";      // the decimals are cut off, not rounded
echo sprintf('%f', 1.5), "\n";
echo sprintf('%.2f', 1.5), "\n";
echo sprintf('%e', 1234.5678), "\n";
echo sprintf('%x %X', 255, 255), "\n";
echo sprintf('%o', 8), "\n";
echo sprintf('%b', 5), "\n";
echo sprintf('%08b', 5), "\n";       // binary padded to 8 bits
echo sprintf('%c', 65), "\n";
echo sprintf('%d%%', 50), "\n";
echo sprintf('%+d %+d', 5, -5), "\n"; // always show the sign

%d 会把浮点数向零截断，所以 42.9 变成 42。如果想得到 43，先四舍五入：sprintf('%d', round(42.9))。不是数字的字符串（比如 'abc'）在 %d 下会变成 0。

用前导零补位

在 % 和字母之间可以放一个填充字符和一个宽度。%05d 的意思是“用 0 补足到 5 位宽”。格式化订单号、发票编号、时间和日期通常就这么写。

<?php
echo sprintf('%05d', 42), "\n";         // 00042
echo sprintf('%03d', 7), "\n";          // 007
echo sprintf('INV-%06d', 1234), "\n";   // INV-001234

// Times and dates from numbers
$h = 9; $m = 5; $s = 3;
echo sprintf('%02d:%02d:%02d', $h, $m, $s), "\n";
echo sprintf('%04d-%02d-%02d', 2026, 3, 14), "\n";

// A width smaller than the number never cuts it
echo sprintf('%03d', 123456), "\n";

宽度是最小值。比宽度更长的数字会完整打印出来。

%05.2f：宽度和小数位一起用

对浮点数来说，宽度计算的是结果的所有字符，包括小数点和负号。所以 %05.2f 作用于 3.14159 得到 03.14：一共五个字符，其中两个在小数点后面。

<?php
$pi = 3.14159;

echo sprintf('%05.2f', $pi), "\n";   // 5 characters in total
echo sprintf('%08.2f', $pi), "\n";   // 8 characters in total
echo sprintf('%.2f', $pi), "\n";     // no width, just 2 decimals
echo sprintf('%.0f', $pi), "\n";     // no decimals
echo sprintf('%.2f', 5), "\n";       // integers get decimals too
echo sprintf('%08.2f', -3.5), "\n";  // the minus sign counts

%f 使用当前区域设置（用 setlocale() 设置）的小数点，而 %F 始终使用点号。如果你的代码设置了区域，而 JSON、CSV 或 API 又需要点号，就用 %F。

按列对齐文本

正数宽度表示右对齐，宽度前加 - 表示左对齐，' 后面跟一个字符可以指定自定义填充字符。把它们组合起来，就能排出整齐的纯文本报表和小票。

<?php
$items = [
    ['Coffee', 2, 3.5],
    ['Croissant', 1, 2.25],
    ['Orange juice', 3, 4],
];

printf("%-14s %3s %8s\n", 'Item', 'Qty', 'Price');
printf("%'-27s\n", '');

$total = 0;
foreach ($items as [$name, $qty, $price]) {
    $line = $qty * $price;
    $total += $line;
    printf("%-14s %3d %8.2f\n", $name, $qty, $line);
}

printf("%'-27s\n", '');
printf("%-14s %12.2f\n", 'Total', $total);
printf("[%'*10s]\n", 'stars');

%-14s 在商品名右侧补空格到 14 个字符，%8.2f 把价格在 8 个字符内右对齐，%'-27s 配合空字符串打印出一行 27 个短横线。%'*10s 用 * 代替空格填充。

给参数编号，重复使用或调换顺序

%1$s 表示“第一个参数，作为字符串”，%2$d 表示“第二个参数，作为整数”。有了编号占位符，你可以重复使用一个值，或者在不改参数列表的情况下调换顺序。当不同语言的语序不一样时，翻译人员正需要这一点。

<?php
// Single quotes: in double quotes PHP would read $s as a variable
$format = '%1$s has %2$d new messages. Open them, %1$s?';
echo sprintf($format, 'Ada', 3), "\n";

// Same arguments, different order in the sentence
$en = 'Page %1$d of %2$d';
$ja = '全%2$dページ中%1$dページ目';
echo sprintf($en, 2, 10), "\n";
echo sprintf($ja, 2, 10), "\n";

// Modifiers go after the $
echo sprintf('%1$05.1f / %1$.3f', 2.71828), "\n";

vsprintf、printf 和返回值

vsprintf() 以一个数组的形式接收所有值，值本来就放在数组里时很方便。printf() 返回它打印的字节数，vprintf() 是 printf() 的数组版本。

<?php
$row = ['Ada', 'Lovelace', 1815];
echo vsprintf("%s %s was born in %d.\n", $row);

$bytes = printf("%s\n", 'Hello');
echo "printf printed $bytes bytes\n";

// Same result, two ways
echo sprintf('%.1f%%', 12.345), "\n";
printf("%.1f%%\n", 12.345);

printf() 返回的计数包含换行符，所以 "Hello\n" 是 6 个字节。对于多字节文本，它数的是字节，而不是字符。

参数太少会抛出错误

从 PHP 8 开始，如果格式里的占位符比值多，会抛出 ArgumentCountError，而不是返回 false。遇到这个错误时，数一数 % 占位符的个数（%% 不算）。

<?php
// This throws an ArgumentCountError on purpose: 3 placeholders, 2 values
echo sprintf('%s bought %d items for %.2f', 'Ada', 3);

错误信息把格式字符串也算作一个参数：ArgumentCountError: 4 arguments are required, 3 given。多余的参数会被悄悄忽略，所以反过来的错误不会报错。如果 sprintf 的结果看起来不对，把格式和值并排打印出来对照。如果你只需要千位分隔符，用 number_format() 比用 sprintf 自己拼要简单。完整的修饰符列表见 php.net。