PHP 數字前補零的最佳實踐：sprintf 與 str_pad

常見場景

訂單編號、會員編號、日期格式化（如 2024_01_05）、流水號等，常需將數字格式化為固定寬度，不足位數前補零。

方法一：sprintf() —— 格式化字串瑞士刀

<?php
// 產生 4 位數，不足前面補 0
$var = sprintf("%04d", 2);
echo $var; // 輸出：0002

// 實際應用：日期_隨機數
echo date('Y_m_d', time()) . '_' . sprintf('%02d', rand(0, 99));
// 輸出範例：2024_01_15_07
?>

sprintf 格式化符號速查

方法二：str_pad() —— 專為填充設計

<?php
$num = 42;

// 預設左側填充（STR_PAD_LEFT）
echo str_pad($num, 5, '0', STR_PAD_LEFT);  // "00042"
echo str_pad($num, 5, '0', STR_PAD_RIGHT); // "42000"
echo str_pad($num, 5, '0', STR_PAD_BOTH);  // "04200" (左右分配)
?>

方法三：number_format() —— 千分位與小數位格式化

雖非專為補零設計，但常用於金額顯示：

<?php
$number = 1234.5678;

// 英式：千分位逗號，小數點
echo number_format($number, 2, '.', ','); // "1,234.57"

// 法式：千分位空格，小數點逗號
echo number_format($number, 2, ',', ' '); // "1 234,57"

// 無千分位，僅保留小數
echo number_format($number, 2, '.', '');  // "1234.57"
?>

效能與選擇建議

常見錯誤避坑

• sprintf("%04d", "42")：字串會被自動轉型為整數，正常運作
• sprintf("%04d", 3.14)：浮點數會被截斷為 3，輸出 "0003"
• str_pad(42, 3, '0')：若原字串長度 >= 指定寬度，不會截斷，原樣返回 "42"

總結

• 單純補零 → str_pad($num, $len, '0', STR_PAD_LEFT) 最直觀高效
• 複合格式（如 ID-%04d-%s） → sprintf() 一行搞定
• 金額顯示 → number_format() 專業之選