A simple PHP library for Qdrant vector database

Qdrant PHP Client is a simple and easy library for working with Qdrant vector database. It helps you store and search vectors (embeddings) for AI and machine learning applications.

Version 1.0.0 includes complete API support for collections, points, search, and recommendations.

• 🚀 Easy to use — Simple API, clear code
• 🔍 Vector Search — Find similar items by vector similarity
• 📊 Batch Operations — Work with many items at once
• 🎯 Filters — Search with conditions (price, category, etc.)
• 💡 Recommendations — Get recommendations based on examples
• 🧪 100% Tested — All features have tests
• 🐘 PHP 7.2+ — Works with old and new PHP versions
• ⚡ Fast — Uses cURL for speed

• PHP 7.2 or higher
• Extensions: ext-curl, ext-json
• Qdrant server (local or cloud)

Install via Composer:

composer require tenqz/qdrant

<?php

use Tenqz\Qdrant\QdrantClient;
use Tenqz\Qdrant\Transport\Infrastructure\Factory\CurlHttpClientFactory;

// 1. Create client
$factory = new CurlHttpClientFactory();
$httpClient = $factory->create('localhost', 6333);
$client = new QdrantClient($httpClient);

// 2. Create collection
$client->createCollection('my_collection', 4, 'Cosine');

// 3. Add vectors with data
$client->upsertPoints('my_collection', [
    ['id' => 1, 'vector' => [0.1, 0.2, 0.3, 0.4], 'payload' => ['city' => 'Berlin']],
    ['id' => 2, 'vector' => [0.5, 0.6, 0.7, 0.8], 'payload' => ['city' => 'London']],
]);

// 4. Search for similar vectors
$results = $client->search('my_collection', [0.2, 0.1, 0.9, 0.7], 5);

See examples/basicUsage.php and examples/README.md for complete examples of all features.

See examples/basicUsage.php for complete examples of:

• Creating collections with different settings
• Adding and updating data
• Vector similarity search
• Search with filters (price, category, etc.)
• Recommendations (like/unlike items)
• Batch operations
• Pagination with scroll
• And more!

Run the example:

php examples/basicUsage.php

use Tenqz\Qdrant\Transport\Domain\Exception\TransportException;
use Tenqz\Qdrant\Transport\Domain\Exception\HttpException;
use Tenqz\Qdrant\Transport\Domain\Exception\NetworkException;

try {
    $result = $client->search('my_collection', [0.1, 0.2], 10);
    
} catch (HttpException $e) {
    // HTTP errors (404, 500, etc.)
    echo "HTTP Error {$e->getStatusCode()}: {$e->getMessage()}\n";
    print_r($e->getResponse());
    
} catch (NetworkException $e) {
    // Network problems (connection failed, timeout)
    echo "Network Error: {$e->getMessage()}\n";
    
} catch (TransportException $e) {
    // Other transport errors
    echo "Error: {$e->getMessage()}\n";
}

• HttpException — HTTP errors like 404 Not Found, 500 Server Error
• NetworkException — Connection problems, timeouts, DNS errors
• SerializationException — JSON parsing errors
• TransportException — Base class for all errors (catch-all)

Run tests:

composer install
composer test

• Qdrant Documentation
• API Reference
• Examples

Contributions are welcome! Please see CONTRIBUTING.md for detailed guidelines.

Quick steps:

1. Fork the repository
2. Create a feature branch
3. Write tests for new features
4. Submit a pull request

MIT License. See LICENSE for details.

Author: Oleg Patsay
Email: [email protected]
GitHub: tenqz/qdrant

⭐ Like this project? Give it a star on GitHub!