Download the PHP package azaharizaman/nexus-connector without Composer
On this page you can find all versions of the php package azaharizaman/nexus-connector. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download azaharizaman/nexus-connector
More information about azaharizaman/nexus-connector
Files in azaharizaman/nexus-connector
Download azaharizaman/nexus-connector
More information about azaharizaman/nexus-connector
Files in azaharizaman/nexus-connector
Vendor azaharizaman
Package nexus-connector
Short Description Framework-agnostic integration hub for external API communication with retry, circuit breaker, and rate limiting support
License MIT
Package nexus-connector
Short Description Framework-agnostic integration hub for external API communication with retry, circuit breaker, and rate limiting support
License MIT
Please rate this library. Is it a good library?
Informations about the package nexus-connector
Nexus\Connector
A framework-agnostic PHP package providing a standardized, central gateway for external API communication with built-in resilience patterns.
Purpose
Nexus\Connector solves the problem of external communication complexity by providing:
- Vendor Abstraction: Swap external providers (Mailchimp → SendGrid) without changing business logic
- Resilience: Built-in retry logic, circuit breaker, and rate limiting
- Security: Centralized credential management and request/response sanitization
- Observability: Comprehensive integration logging and metrics
- Maintainability: Clean separation between domain contracts and vendor implementations
Installation
Architecture
The Plugin/Adapter Pattern
The package defines domain-specific interfaces (Email, SMS, Payment, etc.) that vendors adapt to. This enables zero-code vendor swapping.
Core Concepts
1. Domain Interfaces
Each service type has a dedicated interface:
EmailServiceConnectorInterface: Transactional & bulk emailSmsServiceConnectorInterface: SMS messagingPaymentGatewayConnectorInterface: Payment processingCloudStorageConnectorInterface: File storageShippingProviderConnectorInterface: Shipment tracking- And 5 more...
2. Resilience Features
- Retry Handler: Exponential backoff with configurable attempts
- Circuit Breaker: Prevents cascading failures (opens after N failures)
- Rate Limiter: Token bucket algorithm per service/endpoint
- Timeout Management: Configurable request timeouts per endpoint
- Idempotency Keys: Prevents duplicate operations (e.g., duplicate payments)
- OAuth Token Refresh: Automatic access token renewal
3. Supporting Contracts
CredentialProviderInterface: Secure credential retrieval with OAuth refreshIntegrationLoggerInterface: Audit trail for all external callsWebhookVerifierInterface: Signature validationHttpClientInterface: HTTP client abstraction for timeout enforcementIdempotencyStoreInterface: Response caching for duplicate prevention
Usage
Basic Example
Advanced Usage with Resilience Patterns
Vendor Swapping (Application Layer)
Creating a Vendor Adapter
- Implement the domain interface
- Use vendor SDK internally
- Map domain methods to vendor API calls
Requirements
- PHP 8.3 or higher
- No framework dependencies (pure PHP)
Documentation
📘 Package Documentation
- Getting Started Guide - Quick start, core concepts, and basic configuration
- API Reference - Complete interface, value object, enum, and exception documentation
- Integration Guide - Laravel and Symfony integration examples with database migrations
- Basic Usage Examples - Email, SMS, payment, and bulk email examples
- Advanced Usage Examples - Custom endpoints, multi-tenant, webhooks, OAuth, cloud storage, metrics
📊 Implementation & Planning
- IMPLEMENTATION_SUMMARY.md - Implementation status, metrics, and key design decisions
- REQUIREMENTS.md - Detailed requirements tracking (110 requirements across 10 categories)
- TEST_SUITE_SUMMARY.md - Testing philosophy and application-layer integration test examples
- VALUATION_MATRIX.md - Package valuation metrics and ROI analysis
🔗 Related Documentation
- Root Implementation Docs - Original comprehensive implementation document
- Resiliency & OAuth - Circuit breaker, retry logic, and OAuth implementation details
Integration
Works seamlessly with other Nexus packages:
- Nexus\AuditLogger: Automatic audit trail for all external calls
- Nexus\Setting: Retrieve endpoint configurations and credentials
- Nexus\Tenant: Multi-tenant credential isolation
- Nexus\Workflow: Orchestrate multi-step integrations
License
MIT License. See LICENSE file for details.
All versions of nexus-connector with dependencies
PHP Build Version
Package Version
The package azaharizaman/nexus-connector contains the following files
Loading the files please wait ...