多商戶(hù)接入阿里云識(shí)圖找商品接入方案
如果要用 PHP 模型（即 PHP 代碼調(diào)用阿里云 Image Search API），阿里云官方也提供了 PHP SDK 與 OpenAPI 方式。下面給你一個(gè)完整的 PHP 多商戶(hù)對(duì)接示例。
1. 準(zhǔn)備工作
- 開(kāi)通阿里云 圖像搜索（Image Search） 實(shí)例。
- 獲取 AccessKeyId / AccessKeySecret。
- 確認(rèn)實(shí)例名（instanceName），區(qū)域一般是 cn-shanghai。
2. 安裝 SDK
推薦使用 Composer：
composer require alibabacloud/sdk
或者指定單獨(dú)的 imagesearch 包（如果有獨(dú)立發(fā)布）。
3. 初始化客戶(hù)端
use AlibabaCloud\Client\AlibabaCloud;
AlibabaCloud::accessKeyClient('<your-access-key-id>', '<your-access-key-secret>')
->regionId('cn-shanghai') // 你的區(qū)域
->asDefaultClient();
4. 入庫(kù)商品圖（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", // 商戶(hù)隔離
"categoryId" => 88888888 // 類(lèi)目ID，可選
]);
$response = $client->add($request);
if ($response->body->success) {
echo "入庫(kù)成功\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'" // 只搜該商戶(hù)
]);
$response = $client->searchImageByPic($request);
foreach ($response->body->auctions as $item) {
echo "PicName: {$item->picName}, Score: {$item->score}\n";
}
6. 多商戶(hù)要點(diǎn)
- picName 命名：merchantId-skuId-imageNo，方便搜索結(jié)果映射回商品。
- strAttr 過(guò)濾：保證不同商戶(hù)之間隔離。
- 分實(shí)例/共用實(shí)例：大商戶(hù)可獨(dú)立實(shí)例，小商戶(hù)共用實(shí)例，通過(guò) filter 控制隔離。
- 下架同步：記得調(diào)用 DeleteImage 刪除無(wú)效圖。
