如何在 PHP 变量前添加符号或文本（如井号 #）

本文详解如何在 PHP 字符串拼接中为变量（如 $order_id）前置添加符号（如 #）或任意文本，并介绍直接拼接与格式化函数（如 sprintf）两种安全、规范的实现方式。

本文详解如何在 PHP 字符串拼接中为变量（如 `$order_id`）前置添加符号（如 `#`）或任意文本，并介绍直接拼接与格式化函数（如 `sprintf`）两种安全、规范的实现方式。

在 WordPress + WooCommerce 短代码开发中，经常需要将动态变量（例如订单 ID $order_id）嵌入 HTML 输出。你当前的代码：

<div class="items_orders_card"> <span class="items_title">Order</span> '. $order_id .' </div>

会输出 Order: 39800，但期望结果是 Order: #39800——即在数字前添加井号 #。

✅ 推荐方案一：字符串直接拼接（简洁高效）

最直接的方式是在变量前插入字符串字面量 '#'，并用点号 . 连接：

<div class="items_orders_card"> <span class="items_title">Order</span> #'. $order_id .' </div>

✅ 优点：语法简单、执行高效，适用于大多数场景。
⚠️ 注意：确保 $order_id 是已定义且非空的标量值（如整数或字符串），否则可能触发 Notice（如 undefined variable 或 null 转字符串为 " "）。

✅ 推荐方案二：使用 sprintf() 格式化（更健壮、可扩展）

若需更强类型控制（例如强制转为整数、补零、多参数组合），推荐使用 sprintf()：

<div class="items_orders_card"> <span class="items_title">Order</span> '. sprintf('#%d', $order_id) .' </div>

• %d 表示将 $order_id 强制格式化为有符号十进制整数；
• 若 $order_id 是字符串（如 '39800'）或浮点数（如 39800.0），%d 会自动截断小数部分并转为整数；
• 若值为 null 或布尔值，%d 会输出 0，有助于避免意外空值导致的显示异常。

? 同样适用于普通文本：例如添加前缀 "ID-"，可写为 sprintf('ID-%s', $order_id)（%s 表示字符串），兼顾灵活性与安全性。

? 安全建议（生产环境必备）

为防止 XSS 或空值问题，建议增强容错处理：

<?php
$order_id = !empty($order_id) ? (int)$order_id : 0;
?>
<div class="items_orders_card">
  <span class="items_title">Order</span>
  #<?php echo esc_html($order_id); ?>
</div>

• 使用 (int) 强制类型转换确保数值安全；
• esc_html() 防止 HTML 注入（尤其当 $order_id 来源不可信时）；
• 避免在 HTML 属性中直接拼接未过滤变量。

✅ 总结

无论添加 #、ID-、[Pending] 还是其他任意文本，核心逻辑一致：通过字符串拼接或格式化函数将静态内容与变量组合。选择方式应基于可读性、健壮性与安全性综合权衡。