Download the PHP package grisaia/nova-poshta without Composer
On this page you can find all versions of the php package grisaia/nova-poshta. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download grisaia/nova-poshta
More information about grisaia/nova-poshta
Files in grisaia/nova-poshta
Package nova-poshta
Short Description PHP library to communicate with Ukrainian delivery service Nova Poshta via API 2.0
License MIT
Informations about the package nova-poshta
PHP Nova Poshta API Client
A modern PHP library for interacting with the Ukrainian delivery service Nova Poshta via their API 2.0. This package provides a clean, type-safe interface for all Nova Poshta services including settlements, warehouses, counterparties, documents, and additional services.
🚀 Features
- Full API 2.0 Coverage: Complete implementation of Nova Poshta API 2.0
- Type Safety: Built with PHP 8.3+ features including strict types and readonly classes
- Service-Oriented Architecture: Clean separation of concerns with dedicated service classes
- Exception Handling: Comprehensive error handling with specific exception types
- PSR-4 Compatible: Follows PSR-4 autoloading standards
- Logging Support: PSR-3 compatible logging interface
- Modern PHP: Leverages enums, readonly properties, and other modern PHP features
📋 Requirements
- PHP 8.3 or higher
- cURL extension
- JSON extension
📦 Installation
Install via Composer:
🔧 Configuration
Basic Setup
🛠️ Usage Examples
Settlement Operations
Warehouse Operations
Counterparty Management
Document Operations
Document Files
Additional Services
City Operations
🏗️ Available Services
| Service | Description |
|---|---|
SettlementService |
Manage settlements, areas, regions, and street search |
WarehouseService |
Handle warehouse listings and types |
CounterpartyService |
Manage counterparties and contact persons |
DocumentService |
Document operations and tracking |
DocumentFileService |
Generate and save document files (labels, invoices) |
CityService |
City management and settlement conversion |
AdditionalService |
Additional services (redirections, changes, returns) |
ScanSheetService |
Scan sheet operations |
🔧 Advanced Configuration
Custom Logging
Error Handling
The library provides specific exception types for different error scenarios:
🧪 Development
Running Tests
Code Quality Tools
This package uses several tools to maintain code quality:
- PHPStan: Static analysis (level max)
- PHPMD: Mess detection
- PHPUnit: Unit testing
🏗️ Architecture
The package follows a clean architecture pattern:
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. Make sure to:
- Follow the existing code style
- Add tests for new functionality
- Update documentation as needed
- Run the test suite before submitting
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔗 Links
📞 Support
If you encounter any issues or have questions, please:
- Check the API documentation
- Review existing issues
- Create a new issue with detailed information
All versions of nova-poshta with dependencies
ext-curl Version *
ext-json Version *
grisaia/time Version ^0.2.0
psr/log Version ^3.0