三大函數核心差異一覽
| 函數 | 功能 | 返回值 | 輸出方式 | 參數 | 典型用途 |
printf() | 格式化並直接輸出 | 輸出字串長度 (int) | 直接輸出到輸出緩衝區 | format, args... | 直接顯示、日誌記錄 |
sprintf() | 格式化並返回字串 | 格式化後的字串 | 不輸出,返回字串 | format, args... | 字串構建、SQL 組裝、模板填充 |
print() | 輸出單一字串 | 永遠返回 1 (int) | 直接輸出 | 單一字串表達式 | 簡單輸出、條件輸出 |
格式化字串語法(printf/sprintf 共用)
%[參數][寬度][.精度]類型
類型轉換符
| 符號 | 含義 | 範例輸出 |
% | 字面百分號 | %% → % |
b | 二進制 | 10 → 1010 |
c | ASCII 字元 | 65 → A |
d | 有號十進制整數 | -10 → -10 |
e/E | 科學記號 (小寫/大寫 e) | 1000 → 1.000000e+3 |
f/F | 浮點數(區域感知/不感知) | 3.14 → 3.14 |
g/G | 短模式(自動選 f/e) | 1000 → 1000 |
o | 八進制 | 10 → 12 |
s | 字串 | "hi" → hi |
x/X | 十六進制(小寫/大寫) | 255 → ff / FF |
u | 無號十進制整數 | -1 → 4294967295 (32位) |
進階格式控制
<?php
$num = 12.3456;
// 寬度與填充
printf("%10.2f\n", $num); // " 12.35" (寬度10,右對齊空格填充)
printf("%010.2f\n", $num); // "000012.35" (前導零填充)
printf("%-10.2f\n", $num); // "12.35 " (左對齊)
// 正負號強制顯示
printf("%+d\n", 10); // +10
printf("%+d\n", -10); // -10
printf("% d\n", 10); // 10 (正數前加空格)
// 參數交換(位置參數,PHP 4.0.6+)
$fmt = '第 %2$d 個參數是 %1$s';
printf($fmt, 'apple', 1); // 第 1 個參數是 apple
// 精度控制
printf("%.2f\n", 3.14159); // 3.14
printf("%.0f\n", 3.14159); // 3
?>
實戰範例:四捨五入保留兩位小數
<?php
$nums = [21, 16.3287, 32.12329, 5.045, 5.055];
foreach ($nums as $n) {
// sprintf 返回字串,保證兩位小數(含尾隨 0)
$formatted = sprintf("%.2f", $n);
echo "sprintf: $formatted\n";
// printf 直接輸出
printf("printf: %.2f\n", $n);
// round 返回數值
echo "round: " . round($n, 2) . "\n";
echo "---\n";
}
/* 輸出:
sprintf: 21.00
printf: 21.00
round: 21
---
sprintf: 16.33
printf: 16.33
round: 16.33
---
sprintf: 32.12
printf: 32.12
round: 32.12
---
sprintf: 5.05
printf: 5.05
round: 5.05
---
sprintf: 5.06
printf: 5.06
round: 5.06
*/
?>
效能對比
<?php
$iterations = 1_000_000;
$fmt = "Value: %d, Rate: %.4f, Name: %s";
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
sprintf($fmt, $i, $i * 0.1, 'test');
}
echo "sprintf: " . (microtime(true) - $start) . "s\n";
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
printf($fmt, $i, $i * 0.1, 'test');
}
echo "printf: " . (microtime(true) - $start) . "s\n";
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
print("Value: $i, Rate: " . ($i * 0.1) . ", Name: test");
}
echo "print: " . (microtime(true) - $start) . "s\n";
/* 典型結果:
sprintf: 0.45s
printf: 0.52s (含輸出開銷)
print: 0.38s (簡單拼接最快,但無格式化功能)
*/
?>
常見陷阱
- 型別不匹配:
%d 接收浮點數會截斷,%s 接收陣列會觸發 Notice 並輸出 Array
- 參數數量不符:缺參數 → Warning,多參數 → 忽略
- 多位元組字串寬度計算:
%10s 寬度按位元組非字元計算,中文會對齊錯位
- 浮點數精度:
sprintf("%.2f", 5.045) 可能得 5.04(二進制表示誤差),金額請用整數分或 BCMath
現代替代方案
| 需求 | 推薦方案 |
| 簡單變數插值 | "Hello $name"、"Hello {$user->name}" |
| 複雜模板 | Twig、Blade、Latte、Plates 模板引擎 |
| SQL 參數化 | PDO Prepared Statements (?/:name) |
| 國際化格式化 | NumberFormatter (intl 擴展)、DateTime::format() |
| 結構化日誌 | Monolog + JSON 格式化器 |
總結
- sprintf():構建格式化字串,返回字串,最通用、最常用
- printf():
echo sprintf() 的語法糖,直接輸出,返回長度
- print():單一字串輸出,無格式化,返回 1,語法上是語言結構非函數
- 選型原則:需字串用 sprintf、需直接輸出用 printf/echo、簡單拼接用雙引號/字串連接