PHP sprintf() 格式化字串完整指南

語法

sprintf(string $format, mixed ...$values): string

格式化佔位符完整表

進階功能：引數編號、寬度、精度、填補

<?php
$num = 123.456789;

// 1. 引數編號 %1$ 重複使用同一引數
echo sprintf('%1$d / %1$08b / %1$04x', 42); // "42 / 00101010 / 002a"

// 2. 寬度與靠左靠右 %[width] / %-[width]
echo sprintf("|%10s|", 'a');  // "|         a|"
echo sprintf("|%-10s|", 'a'); // "|a         |"

// 3. 精度 .N (浮點數小數位、字串截斷)
echo sprintf("%.2f", $num);    // "123.46"
echo sprintf("%.5s", 'hello world'); // "hello"

// 4. 零填補 %0[width]d
echo sprintf("%05d", 7);       // "00007"

// 5. 正負號強制顯示 %+d / % d
echo sprintf("%+d", 10);       // "+10"
echo sprintf("% d", -10);      // "-10" (正數前加空格)

// 6. 組合：%[arg$][flags][width][.precision]specifier
echo sprintf('%2$03d %1$05s', 'abc', 7); // "007 00abc"
?>

實用場景範例

組合 MIME 類型

$mime = sprintf('%s/%s', 'application', 'pdf'); // "application/pdf"

產生固定長度流水號

$sn = sprintf('ORD%08d', 123); // "ORD00000123"

SQL 參數化佔位符 (PDO 不需手動，但有時用於組合結構)

$sql = sprintf(
    'SELECT * FROM %s WHERE %s = ? ORDER BY %s LIMIT ?,?',
    'users', 'status', 'created_at'
);

格式化金額（含千分位、固定小數）

// number_format 更適合，但 sprintf 可組合
echo sprintf('NT$ %s', number_format(1234567.5, 2, '.', ',')); // "NT$ 1,234,567.50"

常見錯誤

• 佔位符數量不符：少於引數會警告，多於引數需用編號佔位符 `%1$s` 重複使用
• 型別不符：`%d` 接收字串會轉整數 (導致 0)，建議先轉型
• 多位元組字串寬度：`%10s` 寬度按**位元組**計算，中文會對齊錯位，需用 `mb_strimwidth` 或自行處理

1. 上一篇文章： PHP 檔案下載與線上預覽 PDF 實作範例
2. 下一篇文章： PHP 輸入資料安全過濾函數（支援 GET/POST/COOKIE、魔術引號相容）

PHP 綜合知識

Yii Framework 教程（12）：CClipWidget 片段快取範例

CClipWidget 提供類似「錄製巨集」的功能：定義在

尾遞歸深度解析：原理、跨語言優化差異與 PHP 實測

什麼是尾遞歸？ 函數的最後一步操作是遞歸呼叫自身，且將計算結

PHP 調試工具 PHP Debug Tools 安裝與使用教學（支援 Xdebug）

工具簡介 PHP Debug Tools 是一套基於 Web

Laravel 建構子自動依賴注入原理：反射機制與容器解析深度解析

現象展示 Laravel 控制器建構子無需手動實例化依賴，直