Download the PHP package netresearch/sdk-eu-vat without Composer
On this page you can find all versions of the php package netresearch/sdk-eu-vat. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download netresearch/sdk-eu-vat
More information about netresearch/sdk-eu-vat
Files in netresearch/sdk-eu-vat
Package sdk-eu-vat
Short Description PHP SDK for EU VAT Retrieval Service SOAP API
License MIT
Homepage https://github.com/netresearch/sdk-eu-vat
Informations about the package sdk-eu-vat
EU VAT SOAP SDK
A modern PHP 8.2+ SDK for the EU VAT Retrieval Service that provides reliable access to official VAT rates for all EU member states with precision financial calculations.
Features
- ๐ฆ Financial-Grade Precision: Uses
brick/mathBigDecimal for exact VAT calculations - ๐ก๏ธ Enterprise Ready: Comprehensive error handling, logging, and telemetry
- ๐งช Thoroughly Tested: 368 tests with 95%+ coverage and real service validation
- ๐ Modern SOAP: Built on
php-soap/ext-soap-enginefor reliable SOAP operations - ๐ Observability: Built-in request/response logging and metrics
- ๐ Performance: Optimized with WSDL caching and connection pooling support
- ๐ Well Documented: Comprehensive PHPDoc and usage examples
Installation
Requirements: PHP 8.2+, ext-soap and ext-libxml extensions
๐ก Having installation issues? See the Installation Guide for troubleshooting help.
Quick Start
Advanced Usage
Multiple Countries
Precision Financial Calculations
Custom Configuration
Error Handling
The SDK provides comprehensive exception handling:
Testing
The SDK includes comprehensive test suites:
Test Environment
Integration tests use php-vcr to record and replay real SOAP interactions:
Examples
See the examples/ directory for comprehensive usage examples:
basic-usage.php- Simple VAT rate retrievaladvanced-configuration.php- Custom logging and configurationenterprise-integration.php- Telemetry and monitoringbatch-processing.php- Multiple country querieserror-handling.php- Exception handling patterns
Framework Integration
Symfony
Laravel
Performance
The SDK is optimized for production use:
- WSDL Caching: Automatic WSDL caching reduces initialization overhead
- Connection Reuse: Efficient SOAP connection handling
- Memory Efficient: Optimized DTOs and response handling for efficient batch processing
- Benchmarks: ~10ms typical response time for single country requests
Recommended Production Settings
Security
Input Validation
All inputs are strictly validated:
- Country codes must be valid 2-character ISO codes
- Dates are validated and normalized
- SOAP responses are schema-validated
Error Information Disclosure
Error messages are carefully crafted to be helpful for debugging while avoiding sensitive information disclosure.
Dependencies
All dependencies are regularly scanned for security vulnerabilities:
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Make your changes with tests
- Run the test suite (
composer test) - Run static analysis (
composer analyse) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Development Requirements
- PHP 8.2+
- Composer 2.0+
- All quality tools must pass (PHPStan level 8, PHPCS PSR-12)
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
- Documentation: Full API documentation available in the
docs/directory - Issues: Report bugs and feature requests on GitHub Issues
- Security: Report security vulnerabilities via GitHub Security Advisories
Changelog
See CHANGELOG.md for a detailed list of changes and upgrade instructions.
Note: This SDK provides access to official EU VAT data. Please ensure compliance with your local tax regulations and consult with tax professionals for specific tax advice.
All versions of sdk-eu-vat with dependencies
ext-libxml Version *
ext-soap Version *
brick/math Version ^0.11 || ^0.12
php-soap/ext-soap-engine Version ^1.7
psr/log Version ^1.0 || ^2.0 || ^3.0
ramsey/uuid Version ^4.7
symfony/event-dispatcher Version ^6.0