README

Qdrant PHP Client

A simple PHP library for Qdrant vector database

📖 About

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.

✨ Features

• 🚀 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

📋 Requirements

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

📦 Installation

Install via Composer:

composer require tenqz/qdrant

🚀 Quick Start

<?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.

📚 API Methods

Collections

Points Operations

Search & Recommendations

💡 Examples

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

🛡️ Error Handling

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";
}

Error Types

• 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)

🧪 Testing

Run tests:

composer install
composer test

📖 Documentation

• Qdrant Documentation
• API Reference
• Examples

🤝 Contributing

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

📄 License

MIT License. See LICENSE for details.

📞 Contact

Author: Oleg Patsay
Email: smmartbiz@gmail.com
GitHub: tenqz/qdrant

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