PHP多商户接入阿里云识图找商品

多商户接入阿里云识图找商品接入方案

如果要用 PHP 模型 （即 PHP 代码调用阿里云 Image Search API），阿里云官方也提供了 PHP SDK 与 OpenAPI 方式 。下面给你一个完整的 PHP 多商户对接示例。

1. 准备工作

开通阿里云图像搜索（Image Search）实例。
获取 AccessKeyId / AccessKeySecret。
确认实例名（instanceName），区域一般是 cn-shanghai。

2. 安装 SDK

推荐使用 Composer：

复制代码

composer require alibabacloud/sdk

或者指定单独的 imagesearch 包（如果有独立发布）。

3. 初始化客户端

复制代码

use AlibabaCloud\Client\AlibabaCloud;

AlibabaCloud::accessKeyClient('<your-access-key-id>', '<your-access-key-secret>')
    ->regionId('cn-shanghai') // 你的区域
    ->asDefaultClient();

4. 入库商品图（AddImage）

复制代码

use AlibabaCloud\SDK\Imagesearch\V20190325\Imagesearch;
use AlibabaCloud\SDK\Imagesearch\V20190325\Models\AddRequest;

$client = new Imagesearch();

$request = new AddRequest([
    "instanceName" => "your-instance-name",
    "picName"      => "merchant123-sku999-main1", // picName 建议拼 merchantId + sku
    "picUrl"       => "https://your-oss-bucket.oss-cn-shanghai.aliyuncs.com/path/to/image.jpg",
    "strAttr"      => "merchant123",  // 商户隔离
    "categoryId"   => 88888888         // 类目ID，可选
]);

$response = $client->add($request);

if ($response->body->success) {
    echo "入库成功\n";
} else {
    echo "失败: " . $response->body->message . "\n";
}

5. 搜索商品图（SearchImageByPic）

复制代码

use AlibabaCloud\SDK\Imagesearch\V20190325\Models\SearchImageByPicRequest;

$imageBytes = file_get_contents('/path/to/query.jpg');
$base64Img  = base64_encode($imageBytes);

$request = new SearchImageByPicRequest([
    "instanceName" => "your-instance-name",
    "picContent"   => $base64Img,
    "num"          => 10, // 返回Top10
    "filter"       => "str_attr='merchant123'" // 只搜该商户
]);

$response = $client->searchImageByPic($request);

foreach ($response->body->auctions as $item) {
    echo "PicName: {$item->picName}, Score: {$item->score}\n";
}

6. 多商户要点

picName 命名：merchantId-skuId-imageNo，方便搜索结果映射回商品。
strAttr 过滤：保证不同商户之间隔离。
分实例/共用实例：大商户可独立实例，小商户共用实例，通过 filter 控制隔离。
下架同步：记得调用 DeleteImage 删除无效图。

附件联系博主获取