# php-milvus

**Repository Path**: web/php-milvus

## Basic Information

- **Project Name**: php-milvus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hejunjie/milvus

<div align="center">
  <a href="./README.md">English</a>｜<a href="./README.zh-CN.md">简体中文</a>
  <hr width="50%"/>
</div>

一个轻量级的 PHP 库，用来通过 RESTful API 调用 Milvus 向量数据库，可以用它来管理集合、插入数据，以及进行向量搜索

**本项目已经经由 Zread 解析完成，如果需要快速了解项目，可以点击此处进行查看：[了解本项目](https://zread.ai/zxc7563598/php-milvus)**

---

## 安装

```bash
composer require hejunjie/milvus
```

---

## 使用方法

下面是基本用法，完整支持的操作已在下方列出。

所有方法都有完整注释，参数说明可在对应方法的注释里找到。

### 初始化客户端

```php
use Hejunjie\Milvus;

$client = new Milvus\Client($baseUrl, $apiKey);
```

### 创建集合

```php
$client->collections()->create(string $collectionName, array $schema, ?array $indexParams = null);
```

### 插入数据

```php
$client->entities()->insert(string $collectionName, array $data, ?string $partitionName = null);
```

### 向量搜索

```php
$results = $client->entities()->search(string $collectionName, array $data, string $annsField);
```

---

## 支持的方法

- **Client** - 主入口
  - **customize** - 自定义请求
  - **collections** - 集合操作
    - **create** - 创建集合
    - **describe** - 获取集合信息
    - **drop** - 删除集合
    - **get_load_state** - 获取集合加载状态
    - **get_stats** - 获取集合状态
    - **has** - 检查集合是否存在
    - **list** - 获取所有集合名称
    - **load** - 加载集合
    - **release** - 释放集合
    - **rename** - 重命名集合
    - **alter_properties** - 设置集合属性
    - **drop_properties** - 删除集合属性
  - **partitions** - 分区操作
    - **create** - 创建分区
    - **drop** - 删除分区
    - **get_stats** - 获取分区状态
    - **has** - 检查分区是否存在
    - **list** - 获取分区列表
    - **load** - 加载分区
    - **release** - 释放分区
  - **indexes** - 索引操作
    - **create** - 创建索引
    - **describe** - 查看索引信息
    - **drop** - 删除索引
    - **list** - 查看所有索引
  - **aliases** - 别名操作
    - **alter** - 修改别名
    - **create** - 创建别名
    - **describe** - 查看别名
    - **drop** - 删除别名
    - **list** - 查看所有别名
  - **entities** - 向量数据操作
    - **delete** - 删除数据
    - **get** - 根据主键获取数据
    - **query** - 根据过滤表达式获取数据
    - **insert** - 插入数据
    - **upsert** - 更新数据
    - **search** - 向量搜索

---

## 开发初衷

一般来说，PHP 很少会用到向量数据库，但事情是这样开始的：我在用一个“带点颜色”的小说网站，内容都是几万字的小短文。网站本身挺好，但每天只能看几篇，而且还不支持搜索。一气之下，我写了一个爬虫，把所有小说都爬了下来。

拿到这么多小说后，问题又来了——想找特定内容几乎不可能。这时我想到了 Milvus。我的 2 核 2G 小服务器根本跑不了本地部署，连向量化都不行。但 Milvus 有托管服务，而且带免费额度。我可以在 Mac 上跑向量化，把数据上传上去，后续搜索时需要的向量查询可以用 SiliconFlow 的免费额度搞定。

于是，我就需要一个 PHP 库来操作 Milvus，让整个流程顺利进行，这样我就能轻松按自己想要的条件搜索小说了。

~~（唯一的问题是免费额度不大，只够存 5G 数据，但已经足够了，而且没花钱）~~

---

## 欢迎

如果你觉得这个库有用，欢迎给个 ⭐，或者提交 issue/PR，交流想法都可以。