README

这是根据语雀文档封装的 PHP SDK，不包含 CPS 部分。

环境

PHP >= 8.0
扩展：curl、json、openssl

composer dump-autoload

快速使用

<?php

require __DIR__ . '/vendor/autoload.php';

use Meizhuan\BwcSdk\Client;

$client = Client::test('clientId', 'clientSecret');

$list = $client->tasks()->getList('13800138000', 118.795075, 31.976364, [
    'pageNum' => 1,
    'pageSize' => 20,
]);

$detail = $client->tasks()->getDetail('13800138000', 3495340, 118.795075, 31.976364);

$apply = $client->tasks()->apply('13800138000', 3495340, 118.795075, 31.976364);

活动接口会自动处理：

clientId
timestamp
sign
mobile 的 AES 加密

如果 mobile 已经加密，可以传：

$client->tasks()->getList($encryptedMobile, 118.795075, 31.976364, [
    'mobileEncrypted' => true,
]);

订单接口

$order = $client->orders()->detail('BWC202509050901248rqv31z5');

$client->orders()->submitTakeoutNo(
    'BWC202509050901248rqv31z5',
    '6677889902987653678'
);

$client->orders()->submit(
    'BWC202509050901248rqv31z5',
    'https://example.com/order-number.jpg',
    'https://example.com/order-shop.jpg',
    [
        'feedbackImg' => 'https://example.com/feedback.jpg',
        'afterSaleImg' => 'https://example.com/after-sale.jpg',
        'videoUrl' => 'https://example.com/video.mp4',
        'takeoutOrderNo' => '6677889902987653678',
    ]
);

$client->orders()->cancel('BWC202509050901248rqv31z5');
$client->orders()->preAudit('BWC202509050901248rqv31z5');

文档中订单接口公共参数只明确写了 clientId，所以 SDK 默认不对订单接口追加 timestamp/sign。如果美赚实际要求订单也签名，可以初始化时打开：

$client = Client::test('clientId', 'clientSecret', [
    'signOrderRequests' => true,
]);

请求日志

SDK 不直接依赖业务项目的日志类。调用方可以通过 logger 选项注入一个 callable，SDK 每次请求都会传入完整请求 URL、参数、返回结果、耗时和日志级别。

在 yy_oms_admin 项目中可以这样接入 SysLogger：

use Meizhuan\BwcSdk\Client;
use library\log\SysLogger;

$sysLogger = SysLogger::getInstance('meizhuan-bwc');

$client = Client::test($clientId, $clientSecret, [
    'logger' => static function (array $log) use ($sysLogger): void {
        $sysLogger->logApi(
            $log['url'],
            json_encode($log['params'], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
            json_encode($log['result'], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
            (float) $log['duration'],
            (string) $log['level'],
            (string) $log['message'],
            'meizhuan-bwc'
        );
    },
]);

接口返回 code != 200、HTTP 非 2xx、cURL 错误、非 JSON 响应时，SDK 都不会抛 ApiException。如果接口有 JSON 返回，会直接返回该数组；如果没有可解析 JSON，会返回包含 code、msg、http_status、raw/curl_error 的数组，并同样写日志。

回调验签

$rawBody = file_get_contents('php://input');

if (!$client->callbacks()->verifyRawJson($rawBody)) {
    http_response_code(401);
    echo 'invalid signature';
    exit;
}

$payload = $client->callbacks()->parseRawJson($rawBody, false);

header('Content-Type: application/json');
echo $client->callbacks()->successJson();

测试

composer test
composer lint

如需使用真实凭证做一次测试环境联调：

cp .env.example .env
# 编辑 .env，填入 clientId/clientSecret
composer integration-test

meizhuan / bwc-sdk

Maintainers

Package info

Statistics

Security

README

环境

快速使用

订单接口

请求日志

回调验签

测试

meizhuan-bwc-sdk