当前位置：首页 > news >正文

meilisearch-php多模态搜索：图像与文本混合搜索的完整实现方案

news 2026/7/18 11:19:13

meilisearch-php多模态搜索：图像与文本混合搜索的完整实现方案

【免费下载链接】meilisearch-phpPHP client for Meilisearch项目地址: https://gitcode.com/gh_mirrors/me/meilisearch-php

meilisearch-php是Meilisearch的PHP客户端，它提供了强大的多模态搜索功能，能够实现图像与文本的混合搜索，为开发者构建智能搜索应用提供了便捷的解决方案。

多模态搜索的核心优势

多模态搜索打破了传统单一文本搜索的局限，通过融合图像和文本信息，能够更精准地理解用户意图。无论是电商平台的商品搜索，还是内容管理系统的资源检索，多模态搜索都能显著提升搜索体验，让用户快速找到所需的信息。

实现多模态搜索的关键步骤

配置环境与依赖

首先，确保你的开发环境中已安装PHP和Composer。通过以下命令克隆meilisearch-php仓库：

git clone https://gitcode.com/gh_mirrors/me/meilisearch-php cd meilisearch-php composer install

启用多模态搜索功能

在使用多模态搜索之前，需要启用相关的实验性功能。可以通过发送HTTP请求来实现：

$http = new Client($host, $apiKey); $http->patch('/experimental-features', ['multimodal' => true]);

配置嵌入器（Embedders）

嵌入器是实现多模态搜索的核心组件，它负责将文本和图像转换为向量表示。在meilisearch-php中，可以通过updateEmbedders方法进行配置：

$index->updateEmbedders([ 'multimodal' => [ 'source' => 'rest', 'url' => 'https://api.voyageai.com/v1/multimodalembeddings', 'apiKey' => $voyageApiKey, 'dimensions' => 1024, // 其他配置参数... ] ])->wait();

详细的嵌入器配置可以参考tests/Endpoints/MultiModalSearchTest.php中的getVoyageEmbedderConfig方法。

准备多模态数据

多模态搜索需要同时处理文本和图像数据。在添加文档时，确保包含图像相关的字段，如电影海报的URL或Base64编码数据。

图：用于多模态搜索测试的示例图像（tests/assets/master-yoda.jpeg）

执行多模态搜索

meilisearch-php提供了灵活的搜索接口，可以根据需要执行文本搜索、图像搜索或混合搜索。

文本搜索

$response = $index->search('A movie with lightsabers in space', [ 'media' => [ 'text' => ['text' => $query], ], 'hybrid' => [ 'embedder' => 'multimodal', 'semanticRatio' => 1, ], ]);

图像搜索

$response = $index->search(null, [ 'media' => [ 'poster' => [ 'poster' => $theFifthElementPoster, ], ], 'hybrid' => [ 'embedder' => 'multimodal', 'semanticRatio' => 1, ], ]);

文本与图像混合搜索

$response = $index->search(null, [ 'media' => [ 'textAndPoster' => [ 'text' => $query, 'image' => [ 'mime' => 'image/jpeg', 'data' => $masterYodaBase64, ], ], ], 'hybrid' => [ 'embedder' => 'multimodal', 'semanticRatio' => 1, ], ]);