PHP sprintf() 與 printf() 深度解析：格式化輸出的異同與實戰技巧

PHP sprintf() 與 printf() 深度解析：格式化輸出的異同與實戰技巧

sprintf() 與 printf() 是 PHP 核心字串格式化函數，源自 C 語言 printf 家族。兩者格式字串完全相同，唯一區別在於輸出方式。本文系統梳理格式佔位符、返回值差異、實戰場景與常見坑點。

核心區別一覽

格式佔位符完整速查表

%[參數][寬度][.精度]類型

類型：
  %  - 字面百分號
  b  - 二進制整數
  c  - ASCII 字符
  d  - 有符號十進制整數
  e/E - 科學計數法 (小寫/大寫)
  f/F - 浮點數 (區域感知/不感知)
  g/G - 短數值格式 (自動選 f/e)
  o  - 八進制整數
  s  - 字符串
  u  - 無符號十進制整數
  x/X - 十六進制整數 (小寫/大寫)

參數標誌（旗標）

實戰示例：保留兩位小數（四捨五入）

<?php
$nums = [21, 16.3287, 32.12329, -5.5, 0];
foreach ($nums as $n) {
    // sprintf 返回字串，適合存儲/拼接
    $formatted = sprintf('%0.2f', $n);
    echo "$n → $formatted\n";
}
// 輸出：
// 21 → 21.00
// 16.3287 → 16.33
// 32.12329 → 32.12
// -5.5 → -5.50
// 0 → 0.00

解析 %0.2f：

• % 起始
• 0 填充字符（此處無寬度無效果）
• .2 精度：小數點後 2 位
• f 類型：浮點數

進階實戰場景

1. 生成固定長度訂單號/流水號

$orderNo = sprintf('ORD-%08d', $id); // ORD-00000123

2. SQL 參數化佔位（僅示意，實際用 PDO 預處理）

$sql = sprintf("SELECT * FROM users WHERE status = '%s' AND created_at > '%s'",
    $db->real_escape_string($status),
    $db->real_escape_string($date)
);

3. 文件大小人性化顯示

function humanSize($bytes) {
    $units = ['B', 'KB', 'MB', 'GB', 'TB'];
    $i = 0;
    while ($bytes >= 1024 && $i < 4) { $bytes /= 1024; $i++; }
    return sprintf('%.2f %s', $bytes, $units[$i]);
}

4. 彩色 CLI 輸出（ANSI 轉義序列）

printf("\033[32m[OK]\033[0m %s\n", 'Task completed'); // 綠色
printf("\033[31m[ERR]\033[0m %s\n", $error);       // 紅色

常見坑點與避雷

性能微基準

// 100萬次循環
sprintf('%0.2f', $x);  // ~0.18s
printf('%0.2f', $x);   // ~0.22s (含 I/O)
number_format($x, 2);  // ~0.12s (專用更快)

純數字格式化首選 number_format()；需混合字串、多參數、復雜格式時用 sprintf()；CLI 直接輸出用 printf()。

vprintf / vsprintf：數組參數版

$data = ['張三', 25, '北京'];
echo vsprintf('姓名：%s，年齡：%d，城市：%s', $data);
// 姓名：張三，年齡：25，城市：北京

適合參數已在數組中（如資料庫查詢結果）的場景。