php 顺丰同城配送对接

### PHP 实现顺丰同城配送 API 对接

#### 准备工作
为了成功对接顺丰同城急送API，在开始编码之前，需确保已经获取到必要的API密钥和其他认证信息。这通常包括AppKey和AppSecret等参数[^1]。

#### 创建请求类
创建一个新的PHP文件用于处理与顺丰服务器之间的通信逻辑：

<?php
class SFExpressClient {
    private $app_key;
    private $app_secret;

    public function __construct($app_key, $app_secret){
        $this->app_key = $app_key;
        $this->app_secret = $app_secret;
    }

    protected function buildRequestUrl($endpoint){
        return "https://open.sf-express.com/openapi/v2.0/".$endpoint."?app_key=".$this->app_key."&timestamp=".time();
    }
}

此部分代码定义了一个名为`SFExpressClient`的基础类来封装所有可能的操作方法，并提供构建URL的功能以便后续调用不同端点的服务。

#### 发起POST请求函数
继续扩展上述类以支持发送订单数据给顺丰平台：

public function createOrder($orderData){
    try{
        $url = $this->buildRequestUrl('orders');
        
        // 设置签名算法并附加至请求体中
        $signature = hash_hmac('sha256', json_encode($orderData), $this->app_secret);
        $postFields['data'] = json_encode(array_merge(['sign'=>$signature], $orderData));

        $ch = curl_init();  
        curl_setopt($ch,CURLOPT_URL,$url);  
        curl_setopt($ch,CURLOPT_POST,true);  
        curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields);   
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        $response = curl_exec($ch);
        if(curl_errno($ch)){
            throw new Exception(curl_error($ch));
        }else{
            echo 'Response:'.$response; 
        }
        curl_close ($ch);
    }catch(Exception $e){
        error_log("Error:".$e->getMessage());
    }
}

这段脚本展示了如何通过HTTP POST方式向指定路径提交新的配送任务，同时利用HMAC-SHA256加密技术生成安全校验码(sign)，从而保证传输过程中的信息安全性和完整性。

#### 调用示例
最后给出一个简单的实例说明怎样使用刚才建立好的客户端对象来进行实际操作：

$express_client = new SFExpressClient('your_appkey_here','your_appsecret_here');

// 构建订单详情数组
$orderInfo = [
    'sender_name'=>"张三",
    'receiver_phone'=>"138xxxxxxxx", 
    'pickup_address'=>"北京市朝阳区XX街道"
];

// 执行下单动作
$express_client->createOrder($orderInfo);

以上就是基于PHP语言完成的一套完整的顺丰同城急送API接入流程介绍，希望对开发者有所帮助。