Prestashop 1.7.7.0 订单状态变更为已发货时获取订单详情推送第三方API的实现求助
PrestaShop 1.7.7.0 已发货状态触发第三方接口推送的完整实现方案
核心思路
完全依托PrestaShop内置的订单状态变更钩子完成逻辑挂载,不需要修改系统核心文件,开发的模块后续升级、维护都不会和系统版本冲突,能实现在管理员后台把订单切到“已发货”状态的瞬间,自动拉取订单全量信息推送到第三方应用。
分步落地开发指导
- 第一步:先确定“已发货”状态的唯一标识ID
不要用状态名称做判定依据——毕竟后台可以改状态名、做多语言翻译,很容易因为名称不匹配导致触发失效。进后台「订单 > 订单状态」页面,找到对应“已发货”的状态条目,点编辑时看URL里的id_order_state参数值,把这个数字记下来,后续代码里直接用这个ID做触发判定。 - 第二步:用独立模块挂载系统内置钩子
不要直接改后台控制器、核心类的文件,按最简模块规范建个自定义小模块,核心要挂载的钩子是actionOrderStatusUpdate——这个钩子是系统在订单状态变更操作完成后自动触发,回调参数直接包含变更后的新状态ID、完整的Order订单对象,完全不需要自己从请求里抠参数。
之前测试代码里全靠$_GET取值的写法在这个场景下根本不生效:管理员改订单状态的表单是POST提交的,钩子触发的上下文里根本没有这些GET参数,这么写永远拿不到正确的收件人、商品信息。 - 第三步:钩子触发后的逻辑校验与数据拉取
钩子触发后先做两层前置校验,减少无效执行:- 先判断传入的新状态ID是不是之前记录的“已发货”对应ID,不匹配就直接退出,不跑后续逻辑
- 加防重锁:给订单表加个简单的自定义标记位,如果当前订单已经推送过第三方,就直接跳过,避免管理员反复点保存、刷新页面导致重复推送
数据直接从钩子传入的Order对象里取就行,对应之前测试代码需要的字段,取值方式示例:
// 从钩子传入的$order对象加载关联数据 $deliveryAddress = new Address($order->id_address_delivery); $stateInfo = new State($deliveryAddress->id_state); // 对应测试代码需要的字段 $tel_cl = $deliveryAddress->phone; $name_lastname_cl = trim($deliveryAddress->firstname.' '.$deliveryAddress->lastname); $city_cl = $deliveryAddress->city; $state_cl = $stateInfo->name; $address_cl = trim($deliveryAddress->address1.' '.$deliveryAddress->address2); $tel_2_cl = $deliveryAddress->phone_mobile; // 拼接商品明细与总数量 $productList = []; $totalQty = 0; foreach($order->getProducts() as $product){ $productList[] = $product['product_name'].' *'.$product['product_quantity']; $totalQty += $product['product_quantity']; } $products_str = implode(';', $productList); $cod_amount = $order->total_paid; $order_note = $order->note; - 第四步:修正第三方接口的请求逻辑
原来的拼接URL的写法存在几个问题,调整后稳定性会高很多:- 所有拼到URL里的参数必须自动做编码处理,不要手动拼字符串,不然遇到中文、特殊符号会导致参数截断、传递错误
- 去掉硬编码的
id=123,替换成当前触发推送的实际订单ID - 给请求加超时控制,避免第三方接口响应慢的时候拖慢PrestaShop后台的操作速度
调整后的请求代码示例:
$api_url = 'http://example.com/api/set_parcel_post.php'; $request_data = [ 'id' => $order->id, 'tel_cl' => $tel_cl, 'name_lastname_cl' => $name_lastname_cl, 'city_cl' => $city_cl, 'state_cl' => $state_cl, 'address_cl' => $address_cl, 'tel_2_cl' => $tel_2_cl, 'products' => $products_str, 'cod' => $cod_amount, 'Quantity' => $totalQty, 'note' => $order_note ]; // 自动处理参数编码,生成完整请求URL $full_url = $api_url . '?' . http_build_query($request_data); // 配置请求超时,最多等5秒 $req_context = stream_context_create([ 'http' => [ 'timeout' => 5 ] ]); $response = file_get_contents($full_url, false, $req_context); $push_result = json_decode($response, true); - 第五步:加兜底异常处理
推送逻辑不管成功失败,都要把推送时间、订单ID、第三方返回的内容写到模块自己的日志文件里,不要把接口报错直接抛到后台,干扰管理员正常操作。如果推送失败,绝对不能中断订单状态的变更流程——毕竟状态变更是商店核心操作,第三方接口异常不能影响正常的订单管理。
常见踩坑提醒
- 不要硬靠
$_GET/$_POST取参数,PrestaShop钩子会把所有需要的业务对象直接传给回调,硬取参数在批量改单、API改单的场景下会完全失效 - 不要把推送逻辑写在系统的override目录下的核心类文件里,PrestaShop升级的时候很容易被覆盖,独立模块的方式后续维护成本最低
- 防重逻辑是必须加的,不然管理员调整一次订单状态就推一次,会给第三方接口造成大量无效数据
内容的提问来源于stack exchange,提问作者Wajdi
相关产品推荐
相关产品推荐

