Download the PHP package bmlt-enabled/bmlt-php-query-client without Composer
On this page you can find all versions of the php package bmlt-enabled/bmlt-php-query-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bmlt-enabled/bmlt-php-query-client
More information about bmlt-enabled/bmlt-php-query-client
Files in bmlt-enabled/bmlt-php-query-client
Package bmlt-php-query-client
Short Description A PHP client for querying BMLT (Basic Meeting List Tool) servers with built-in geocoding support
License MIT
Homepage https://github.com/bmlt-enabled/bmlt-php-query-client
Informations about the package bmlt-php-query-client
BMLT PHP Query Client
A modern PHP client for querying BMLT (Basic Meeting List Tool) servers with built-in geocoding support using Guzzle HTTP client.
Features
- 🚀 Modern PHP 8.1+ - Uses enums, readonly classes, and named parameters
- 🏛️ Complete BMLT API coverage - All semantic endpoints supported
- 🌍 Built-in geocoding - Uses OpenStreetMap Nominatim for address-to-coordinates conversion
- 🔍 Type-safe API - Full type definitions with readonly data objects
- ⚡ HTTP client - Built on Guzzle HTTP with proper error handling
- 📦 Composer ready - Easy installation via Composer
- 🎯 Well tested - Comprehensive unit and integration tests
- 🛠️ Developer friendly - Clear exceptions and validation
Requirements
- PHP 8.1 or higher
- ext-curl
- ext-json
Installation
Quick Start
Basic Usage
Using the Factory
API Reference
Client Configuration
Search Methods
Search Meetings
Server Information
Geocoding
Fluent Query Builder
Data Types
The library provides strongly-typed data objects:
Meeting Object
Enums
Error Handling
The library provides comprehensive error handling with specific exception types:
Exception Types
TYPE_NETWORK_ERROR- Network connectivity issues (retryable)TYPE_TIMEOUT_ERROR- Request timeout (retryable)TYPE_VALIDATION_ERROR- Invalid parameters (not retryable)TYPE_GEOCODING_ERROR- Geocoding service error (retryable)TYPE_RESPONSE_ERROR- Invalid server response (retryable for 5xx)TYPE_RATE_LIMIT_ERROR- Too many requests (retryable)
Configuration
Runtime Configuration
You can update client settings after initialization:
Geocoding Options
Testing
The library includes comprehensive tests:
API Documentation
The library includes comprehensive PHPDoc annotations. You can generate HTML API documentation using:
The generated documentation includes:
- Complete API reference for all classes, methods, and properties
- Usage examples and code samples
- Type information and parameter descriptions
- Exception documentation
- Inheritance diagrams
Development
Examples
See the examples/ directory for complete working examples:
- basic-usage.php - Basic API usage examples
- geocoding.php - Geocoding examples
- error-handling.php - Error handling examples
License
MIT License. See LICENSE file for details.
Contributing
Contributions are welcome! Please read the contributing guidelines and submit pull requests.
Support
Related Projects
- bmlt-query-client - TypeScript/JavaScript version
- BMLT Root Server - The BMLT server software
All versions of bmlt-php-query-client with dependencies
ext-curl Version *
ext-json Version *
guzzlehttp/guzzle Version ^7.8
psr/log Version ^1.1|^3.0