huahuibao/common/components/delivery/platform/huolala/Huolala.php

<?php
namespace common\components\delivery\platform\huolala;


use common\components\delivery\helpers\SignHelper;

class Huolala
{
    protected $baseUrl;
    protected $appSecret;
    protected $appKey;
    protected $accessToken;
    protected $apiVersion = '1.0';
    protected $isSandbox;

    /**
     * @var string 订单消息回调地址
     */
    protected $notifyUrl;

    public function __construct($accessToken='')
    {
        if (getenv('YII_ENV') == 'production') { // TODO 先变更为测试  --- production  /  dev
            $cfg = [
                'base_url' => 'https://openapi.huolala.cn/v1',
                'app_key' => 'gBhmCdWtX7hi7qnljduk0yK21XgQg8w3',
                'secret' => 'bARxI68FFHpEXAcCQ23fxVQyxtJ9RONU',
                //'notify_url' => 'https://api.shop.wixhb.com/delivery/huolala-callback', // TODO
                'notify_url' => 'https://api.shop.hzghd.com/delivery/huolala-callback',
            ];
            $this->isSandbox = false;
        } else {
            $cfg = [
                'base_url' => 'https://openapi-pre.huolala.cn/v1',
                'app_key' => '8S2uZQrWwM1mkG2Cj576PsMiNIe25UNT',
                'secret' => 'olzor07UgmUWaagahNGQAKQKXRtvhK8j',
                'notify_url' => 'https://api.shop.hzghd.com/delivery/huolala-callback',
            ];
            $this->isSandbox = true;
        }
        $this->baseUrl = $cfg['base_url'];
        $this->appSecret = $cfg['secret'];
        $this->appKey = $cfg['app_key'];
        $this->accessToken = $accessToken;
        $this->notifyUrl = $cfg['notify_url'];
    }

    /**
     * 构建API请求参数
     * 
     * 根据货拉拉API规范构建完整的请求参数，包括签名
     * 
     * @param string $apiMethod API方法名
     * @param array $apiData 业务参数
     * @param string|null $accessToken 用户授权令牌（可选）
     * @return array 完整的请求参数
     */
    protected function buildRequestPayload($apiMethod, $apiData = [], $accessToken = null)
    {
        // 生成随机数（nonce_str）
        $nonceStr = $this->generateNonceStr();

        // 构建系统级参数
        $payload = [
            'api_method' => $apiMethod,
            'api_version' => $this->apiVersion,
            'app_key' => $this->appKey,
            'timestamp' => time(),
            'nonce_str' => $nonceStr,
        ];

        // 如果提供了访问令牌，加入参数
        if (!empty($accessToken)) {
            $payload['access_token'] = $accessToken;
        }

        // 业务数据作为 JSON 字符串
        // 注意：如果不加 JSON_UNESCAPED_SLASHES，PHP 会把 / 编码成 \/
        //      而很多第三方（包括货拉拉）在服务端是按未转义的 / 参与签名的，
        //      一旦字段里有 URL（如 notify_url），双方签名串就会不一致。
        //      因此这里显式关闭斜杠转义，保证本地和对端采用一致的 JSON 形式参与签名。
        $payload['api_data'] = json_encode($apiData, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

        // 计算签名
        $signature = $this->generateSignature($payload);
        $payload['signature'] = $signature;

        return $payload;
    }

    /**
     * 生成签名
     *
     * 复用 SignHelper 的通用签名算法
     * 货拉拉要求32位小写MD5签名，而 SignHelper 返回大写，所以需要转为小写
     *
     * @param array $params 待签名参数（不包括signature）
     * @return string 签名值（32位小写）
     */
    protected function generateSignature($params)
    {

        // 使用 SignHelper 的通用签名算法
        $sign = SignHelper::makeSign($params, $this->appSecret);

        // 货拉拉 API 要求32位小写，转换为小写
        return strtolower($sign);
    }

    public function generateSignatureWithoutAppSecret($params)
    {
        $sign = SignHelper::makeSign($params, '');
        return strtolower($sign);
    }

    /**
     * 生成随机数字符串
     *
     * @param int $length 长度
     * @return string 随机字符串
     */
    protected function generateNonceStr($length = 16)
    {
        $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
        $str = '';
        for ($i = 0; $i < $length; $i++) {
            $str .= $chars[random_int(0, strlen($chars) - 1)];
        }
        return $str;
    }

    public function getIsSandbox()
    {
        return $this->isSandbox;
    }
}