laravel:ports-and-adapters

To isolate external service SDKs from Laravel domain logic, define ports as PHP interfaces and adapters that wrap vendor SDKs. This hexagonal architecture keeps external dependencies out of your core domain code.

Hexagonal architecture in Laravel uses ports and adapters to separate domain logic from infrastructure. Ports are interfaces expressing application needs, while adapters are provider-specific implementations wrapping external SDKs.

Swap external service providers at runtime in Laravel by using composition to select adapters via configuration. Define ports as interfaces, implement provider-specific adapters, and switch implementations through config settings.

You need ports and adapters in a PHP Laravel project when requiring interchangeable providers and clean separation between domain and infrastructure. This pattern abstracts integrations behind stable interfaces to keep vendor SDKs out of domain code.

No specific dependencies are required to implement Laravel ports and adapters. The pattern relies on native PHP interfaces for ports and composition for adapter selection, keeping vendor SDKs isolated within infrastructure adapters.