PHP解析大麦云API返回的JSON数据，须先用json_decode($res, true)转为关联数组，再检查json_last_error()防HTML错误页干扰；时间戳需除1000后传入date()；price等字符串字段须显式类型转换；分页应依total计算总页数并重试机制保障完整性；字段名如desc、order须用反引号包裹或映射避坑。
大麦云 API 返回的 JSON 数据怎么用 PHP 正确解析
大麦云接口（如 /openapi/v1/order/list）返回的是标准 JSON，但常含中文字段、嵌套结构和时间戳字符串（如 "create_time":"1715234400000"），直接 json_decode($res, true) 会得到数组，但容易忽略字段空值或类型不一致问题。
- 务必检查
json_last_error()，部分接口在错误时仍返回 200 状态码，但 body 是 HTML 错误页（比如登录过期返回 500 页面），此时json_decode会静默失败 - 时间戳字段多为毫秒级，PHP 的
date()不接受毫秒，需先除以 1000 再转：date('Y-m-d H:i:s', (int)($data['create_time'] / 1000)) - 订单商品列表常是
"items": [{"name":"xxx","price": "1200"}]，注意price是字符串，不是数字，直接运算会隐式转换出错，建议显式转为(int)$item['price'] / 100（单位分 → 元）
PHP 调用大麦云接口怎么带签名（sign）和时间戳
大麦云所有写操作（如创建订单、改状态）必须校验 sign，它是对请求参数按字典序拼接 + app_secret 后做 MD5 得到的，漏掉空格、大小写或排序错误都会返回 "code":4001,"msg":"签名错误"。
- 参数必须排除
sign字段本身再参与签名；timestamp必须是当前秒级 Unix 时间戳（不是毫秒），且服务器时间与大麦云相差不能超过 5 分钟 - 推荐用
http_build_query($params, '', '&', PHP_QUERY_RFC3986)拼接，避免手动拼接时 URL 编码不一致（比如空格变+而非%20） - 示例关键逻辑：
$params = ['app_key' => 'xxx', 'timestamp' => time(), 'order_id' => '123'];<br>$str = http_build_query($params, '', '&', PHP_QUERY_RFC3986);<br>$sign = md5($str . $app_secret);<br>$params['sign'] = $sign;
PHP 处理大麦云分页数据怎么避免漏单或重复拉取
大麦云多数列表接口（如订单、商品）用 page_no 和 page_size 分页，但不返回总页数，只返回 "total":1234 和当前页数据。靠循环请求到空结果为止不可靠——网络超时或接口限流可能导致某页丢失，后续页就全偏移。
- 应以
total为准计算总页数：$total_pages = ceil($total / $page_size)，然后严格按 1→N 请求，每页失败需重试（最多 2 次），不跳过 - 每次请求后记录最后一条订单的
order_id或create_time，下次用start_time/end_time做时间窗口增量拉取，比纯分页更稳 - 注意：大麦云部分接口（如物流信息）不支持时间范围查询，只能靠分页 +
last_order_id做游标式拉取，这时需把上一页末尾 ID 传入下一页的last_id参数（如有）
PHP 写入数据库时怎么应对大麦云字段名和 MySQL 关键字冲突
大麦云返回字段如 desc、order、key 在 MySQL 中是保留字，直接当字段名 INSERT 会报错 SQLSTATE[42000]: Syntax error or access violation。
立即学习“PHP免费学习笔记（深入）”；
- 最简方案：所有字段名用反引号包裹，例如
`desc`、`order`，无论建表还是 INSERT 都要加 - 更稳妥做法：在 PHP 层做字段映射，把
desc→item_desc、order→order_sn，既避开关键字，又提升可读性 - 别依赖 ORM 自动转义（如 Laravel 的
DB::table()->insert()默认不处理关键字），必须显式控制字段名输出
