本文介绍如何遍历购物车商品数组，将每个商品的名称、价格、数量等信息转换为 HTML 隐藏输入字段（），并安全地嵌入表单中，适用于支付网关对接或跨页面数据传递场景。
本文介绍如何遍历购物车商品数组，将每个商品的名称、价格、数量等信息转换为 html 隐藏输入字段（``），并安全地嵌入表单中，适用于支付网关对接或跨页面数据传递场景。
在 Web 开发中，常需将购物车内容以结构化方式提交至第三方服务（如支付接口）。此时，不能仅依赖 PHP 数组，还需将其“映射”为浏览器可提交的 HTML 表单字段。核心思路是：先构建标准化数据结构，再逐项渲染为 <input type="hidden"> 元素，同时兼顾安全性与语义清晰性。
以下是一个完整、健壮的实现方案：
<?php
// 1. 初始化响应数据结构（注意：原问题中 'results' 应为 'items'，已修正）
$data = [
'success' => false,
'items' => []
];
// 2. 遍历购物车内容，构建标准化商品项（URL 编码用于兼容 GET/重定向场景）
foreach ($cart->get_contents() as $item) {
$data['items'][] = [
'description' => urlencode($item['name'] ?? ''),
'amount' => urlencode($item['price'] ?? '0.00'),
'quantity' => urlencode($item['qty'] ?? '1')
];
}
$data['success'] = true;
// 3. 渲染隐藏字段 —— 推荐使用 description 作为 name，amount 作为 value
// ⚠️ 注意：若 description 含特殊字符（如空格、引号），直接作 name 可能引发 HTML 解析错误
// ✅ 更稳妥做法：使用固定前缀 + 序号命名，并通过 data-* 属性携带原始描述
$index = 0;
foreach ($data['items'] as $item) {
$descSafe = htmlspecialchars($item['description'], ENT_QUOTES, 'UTF-8');
$amountSafe = htmlspecialchars($item['amount'], ENT_QUOTES, 'UTF-8');
echo "<input type='hidden' name='item[{$index}][description]' value='{$descSafe}'>\n";
echo "<input type='hidden' name='item[{$index}][amount]' value='{$amountSafe}'>\n";
echo "<input type='hidden' name='item[{$index}][quantity]' value='" . htmlspecialchars($item['quantity'], ENT_QUOTES, 'UTF-8') . "'>\n";
$index++;
}
?>? 关键注意事项：
-
不要直接用
urlencode($item['name'])作为<input name="">的值：name属性不接受 URL 编码后的特殊字符（如%20），会导致表单解析失败；应使用htmlspecialchars()处理 HTML 特殊字符，而非urlencode()。 -
推荐结构化命名：如
name="item[0][description]"，便于后端（PHP）通过$_POST['item']直接获取关联数组，避免键名冲突或解析歧义。 -
始终过滤输出：使用
htmlspecialchars(..., ENT_QUOTES)防止 XSS，尤其当商品名含用户输入内容时。 - 若需保留原始未编码商品名用于展示，可在隐藏字段中额外添加：
<input type="hidden" name="item[0][raw_name]" value="<?= htmlspecialchars($item['name'], ENT_QUOTES) ?>">
最终，该方案既满足数据准确传递需求，又符合 Web 安全最佳实践，可无缝集成于表单提交流程中。
