PHPackages                             zwell/qdrant - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. zwell/qdrant

ActiveLibrary[Utility & Helpers](/categories/utility)

zwell/qdrant
============

PHP Client for Qdrant

1.0.6(12mo ago)0263MITPHPPHP ^7.2

Since Nov 29Pushed 12mo agoCompare

[ Source](https://github.com/zwell/qdrant-php)[ Packagist](https://packagist.org/packages/zwell/qdrant)[ RSS](/packages/zwell-qdrant/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (11)Versions (8)Used By (0)

Qdrant PHP Client
=================

[](#qdrant-php-client)

[![Test Application](https://github.com/hkulekci/qdrant-php/actions/workflows/test.yaml/badge.svg)](https://github.com/hkulekci/qdrant-php/actions/workflows/test.yaml) [![codecov](https://camo.githubusercontent.com/7c1c74d1ab107fe01f6b2edc2beaf7021a12f10998e0056dbe43279aee427579/68747470733a2f2f636f6465636f762e696f2f6769746875622f686b756c656b63692f716472616e742d7068702f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d354b3846414930433942)](https://codecov.io/github/hkulekci/qdrant-php)

This library is a PHP Client for Qdrant.

Qdrant is a vector similarity engine & vector database. It deploys as an API service providing search for the nearest high-dimensional vectors. With Qdrant, embeddings or neural network encoders can be turned into full-fledged applications for matching, searching, recommending, and much more!

Installation
============

[](#installation)

You can install the client in your PHP project using composer:

```
composer require zwell/qdrant
```

An example to create a collection :

```
use Qdrant\Endpoints\Collections;
use Qdrant\Http\GuzzleClient;
use Qdrant\Models\Request\CreateCollection;
use Qdrant\Models\Request\VectorParams;

include __DIR__ . "/../vendor/autoload.php";
include_once 'config.php';

$config = new \Qdrant\Config(QDRANT_HOST);
$config->setApiKey(QDRANT_API_KEY);

$client = new Qdrant(new GuzzleClient($config));

$createCollection = new CreateCollection();
$createCollection->addVector(new VectorParams(1024, VectorParams::DISTANCE_COSINE), 'image');
$response = $client->collections('images')->create($createCollection);
```

So now, we can insert a point :

```
use Qdrant\Models\PointsStruct;
use Qdrant\Models\PointStruct;
use Qdrant\Models\VectorStruct;

$points = new PointsStruct();
$points->addPoint(
    new PointStruct(
        (int) $imageId,
        new VectorStruct($data['embeddings'][0], 'image'),
        [
            'id' => 1,
            'meta' => 'Meta data'
        ]
    )
);
$client->collections('images')->points()->upsert($points);
```

While upsert data, if you want to wait for upsert to actually happen, you can use query paramaters:

```
$client->collections('images')->points()->upsert($points, ['wait' => 'true']);

```

You can check for more parameters : [https://qdrant.github.io/qdrant/redoc/index.html#tag/points/operation/upsert\_points](https://qdrant.github.io/qdrant/redoc/index.html#tag/points/operation/upsert_points)

Search with a filter :

```
use Qdrant\Models\Filter\Condition\MatchString;
use Qdrant\Models\Filter\Filter;
use Qdrant\Models\Request\SearchRequest;
use Qdrant\Models\VectorStruct;

$searchRequest = (new SearchRequest(new VectorStruct($embedding, 'elev_pitch')))
    ->setFilter(
        (new Filter())->addMust(
            new MatchString('name', 'Palm')
        )
    )
    ->setLimit(10)
    ->setParams([
        'hnsw_ef' => 128,
        'exact' => false,
    ])
    ->setWithPayload(true);

$response = $client->collections('images')->points()->search($searchRequest);
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance50

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~108 days

Recently: every ~135 days

Total

6

Last Release

361d ago

PHP version history (2 changes)1.0.1PHP ^7.4

1.0.6PHP ^7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/98c81a5b0d00481c32f9b90016d38ae99b43b79df5fc9e3397530871cf939fe0?d=identicon)[zwell](/maintainers/zwell)

---

Top Contributors

[![hkulekci](https://avatars.githubusercontent.com/u/586318?v=4)](https://github.com/hkulekci "hkulekci (81 commits)")[![gregpriday](https://avatars.githubusercontent.com/u/1126859?v=4)](https://github.com/gregpriday "gregpriday (20 commits)")[![zwell](https://avatars.githubusercontent.com/u/5118361?v=4)](https://github.com/zwell "zwell (3 commits)")[![jfxyl](https://avatars.githubusercontent.com/u/29575609?v=4)](https://github.com/jfxyl "jfxyl (3 commits)")[![mbukovy](https://avatars.githubusercontent.com/u/27806309?v=4)](https://github.com/mbukovy "mbukovy (2 commits)")[![NiCr42](https://avatars.githubusercontent.com/u/18549424?v=4)](https://github.com/NiCr42 "NiCr42 (2 commits)")[![yunwuxin](https://avatars.githubusercontent.com/u/2168125?v=4)](https://github.com/yunwuxin "yunwuxin (2 commits)")[![fafiebig](https://avatars.githubusercontent.com/u/499340?v=4)](https://github.com/fafiebig "fafiebig (1 commits)")[![snapshotpl](https://avatars.githubusercontent.com/u/312655?v=4)](https://github.com/snapshotpl "snapshotpl (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/zwell-qdrant/health.svg)

```
[![Health](https://phpackages.com/badges/zwell-qdrant/health.svg)](https://phpackages.com/packages/zwell-qdrant)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[kreait/firebase-php

Firebase Admin SDK

2.4k39.7M72](/packages/kreait-firebase-php)[google/cloud-core

Google Cloud PHP shared dependency, providing functionality useful to all components.

343121.4M79](/packages/google-cloud-core)[aporat/store-receipt-validator

PHP receipt validator for Apple App Store and Amazon Appstore

6503.9M9](/packages/aporat-store-receipt-validator)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[shopify/shopify-api

Shopify API Library for PHP

4634.8M16](/packages/shopify-shopify-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)