如何在Shopware6中通过HTML输入设置LineItem的Payload数据

问题描述 #

我正在使用以下HTML输入创建购物车订单项：

<input type="hidden" name="lineItems[{{ id }}][id]" value="{{ id }}">
<input type="hidden" name="lineItems[{{ id }}][type]" value="product">
<input type="hidden" name="lineItems[{{ id }}][quantity]" value="1">

我希望设置Payload数据，以便在购物车收集器/处理器中使用getPayload()或getPayloadValue()方法，但尝试以下两种写法均无效：
写法1：

<input type="hidden" name="lineItems[{{ id }}][payload][key]" value="value">

写法2：

<input type="hidden" name="lineItems[{{ id }}][payloadData]" value="value">

请问正确的配置方式是什么？

解决方案 #

要正确传递Payload数据并让getPayload()/getPayloadValue()方法正常读取，有两种可靠的配置方式：

方式1：多字段传递Payload键值对 #

如果后端框架支持表单数组解析（如PHP的自动数组解析机制），可以通过多个hidden输入分别传递Payload的每个键值对，确保name属性的层级结构正确：

<!-- 原有订单项字段 -->
<input type="hidden" name="lineItems[{{ id }}][id]" value="{{ id }}">
<input type="hidden" name="lineItems[{{ id }}][type]" value="product">
<input type="hidden" name="lineItems[{{ id }}][quantity]" value="1">

<!-- Payload字段，每个键对应一个输入 -->
<input type="hidden" name="lineItems[{{ id }}][payload][customKey1]" value="customValue1">
<input type="hidden" name="lineItems[{{ id }}][payload][customKey2]" value="customValue2">

这种方式下，后端会自动将payload字段组装为关联数组，调用getPayloadValue('customKey1')就能直接获取对应的值。

方式2：JSON字符串传递完整Payload #

如果系统要求Payload是一个序列化的JSON对象，可以将整个Payload结构转为JSON字符串，放在单个hidden输入中：

<!-- 原有订单项字段 -->
<input type="hidden" name="lineItems[{{ id }}][id]" value="{{ id }}">
<input type="hidden" name="lineItems[{{ id }}][type]" value="product">
<input type="hidden" name="lineItems[{{ id }}][quantity]" value="1">

<!-- 序列化后的Payload JSON字符串 -->
<input type="hidden" name="lineItems[{{ id }}][payload]" value='{"customKey1": "customValue1", "customKey2": "customValue2"}'>

注意这里的value使用单引号包裹，避免JSON中的双引号与HTML属性的双引号冲突。后端在处理时会自动反序列化这个JSON字符串为对象/数组，getPayload()会返回完整的Payload结构，getPayloadValue('customKey1')可直接读取指定键的值。

常见问题排查 #

• 确认后端系统是否支持表单数组解析：如果方式1无效，大概率是后端未开启或不支持数组式表单字段解析，此时优先使用方式2。
• 检查键名拼写：确保使用的是payload而非payloadData，因为getPayload()方法对应的字段名通常是payload。

内容的提问来源于stack exchange，提问作者alexD