如何使用 sprintf 格式化字符串与数字

在日常 PHP 编程中，我们常常需要以特定格式输出字符串或数字，这时候 sprintf() 函数就是你的好帮手。它不仅能让输出更加可控，还能让代码更整洁、可读性更强。本文将带你系统地掌握 sprintf() 的使用方法和技巧。

一、什么是 sprintf()？

sprintf() 是 PHP 中的一个内置函数，用于将格式化的字符串作为结果返回（不会直接输出）。这与 printf() 类似，但 printf() 是直接输出，而 sprintf() 是返回结果后供你自由处理。

函数原型如下：

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

• $format：格式模板字符串。

• $values：要插入格式模板中的一个或多个值。

二、sprintf() 的基本用法

示例 1：格式化字符串

$name = '小明';
$city = '北京';
$message = sprintf("你好，我是%s，我来自%s。", $name, $city);
echo $message;

输出结果：

你好，我是小明，我来自北京。

示例 2：格式化数字

$price = 49.5;
$message = sprintf("商品价格是 %.2f 元", $price);
echo $message;

输出结果：

商品价格是 49.50 元

说明：

• %.2f 表示保留两位小数的浮点数。

三、常用格式控制符

四、实用示例：生成带参数的链接

假设你需要生成一个产品详情页的链接，参数包括产品 ID 和名称：

$productId = 123;
$productName = '蓝牙耳机';
$url = sprintf("https://gitbox.net/product/view.php?id=%d&name=%s", $productId, urlencode($productName));
echo $url;

输出结果：

https://gitbox.net/product/view.php?id=123&name=%E8%93%9D%E7%89%99%E8%80%B3%E6%9C%BA

五、sprintf() 的高级用法技巧

1. 多次重复使用参数

你可以用编号方式在格式串中重复某个参数：

$name = '张三';
$message = sprintf("%1\$s，你好！%1\$s，请注意查收邮件。", $name);
echo $message;

输出结果：

张三，你好！张三，请注意查收邮件。

说明：%1\$s 表示使用第一个参数。

2. 对齐输出（适合生成表格）

$line = sprintf("| %-10s | %10s |", "商品", "价格");
echo $line;

输出结果：

| 商品        |       价格 |

说明：

• %-10s：左对齐，占10个字符宽；

• %10s：右对齐，占10个字符宽。

六、sprintf 与安全性

使用 sprintf() 虽然格式化灵活，但在涉及输出到网页、数据库、文件时仍然要注意安全：

• 输出到网页时，记得使用 htmlspecialchars()；

• 构建 SQL 时，避免直接用 sprintf() 拼接，建议使用参数绑定（如 PDO 或 mysqli 的预处理语句）；

• URL 中的参数建议用 urlencode() 编码。

七、总结

sprintf() 是一个功能强大且优雅的格式化工具，只要掌握基本语法和格式控制符，你就能在字符串处理上如虎添翼。无论是页面展示、日志记录、还是生成结构化数据，它都能帮你写出更清晰、可维护的代码。

快把它应用到你的项目中吧！