laravel:ports-and-adapters

To decouple Laravel application logic from external service SDKs, implement the Ports and Adapters pattern by defining PHP interfaces for application needs and creating provider-specific adapters that encapsulate SDK quirks. This enables adapter selection at the composition edge via configuration.

The Ports and Adapters architecture pattern in PHP abstracts external system integrations by defining application-specific interfaces (ports) and creating provider-specific adapters that wrap SDK quirks, allowing adapter selection at the composition root based on configuration.

Switch between different email sending services in Laravel without altering core business logic by abstracting the MailPort interface. Create separate adapters for each provider like SES, SendGrid, or SMTP, and select the appropriate adapter at the service provider composition root via configuration.

Yes, you can use service providers to select adapters at the composition root in Laravel. The Ports and Adapters pattern allows choosing the appropriate provider-specific adapter based on application configuration, enabling seamless switching between external service implementations.

Use hexagonal architecture to abstract external integrations when your codebase is tightly coupled to specific external service SDKs, making it brittle and difficult to test or switch providers. Defining clear PHP interfaces for ports solves this by encapsulating SDK-specific logic in adapters.