多商户接入阿里云识图找商品接入方案
如果要用 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 删除无效图。
