Discovery Laravel Package

Product Decisions This Supports

• Enables building library-agnostic SDKs that avoid forcing specific HTTP client dependencies on consumers, reducing integration friction and vendor lock-in
• Supports "build vs buy" decisions by providing a standardized, community-maintained discovery mechanism instead of custom in-house solutions
• Critical for roadmap planning when supporting multiple PHP frameworks or environments where HTTP client availability varies (e.g., Symfony, Laravel, Magento)
• Reduces maintenance overhead by leveraging PSR standards for interoperability, ensuring compatibility as underlying HTTP implementations evolve

When to Consider This Package

Adopt this package when developing reusable PHP libraries or SDKs that require HTTP capabilities but need to avoid dictating specific client implementations to consumers. It's ideal for projects strictly adhering to PSR-17/PSR-18 standards where runtime discovery of compatible HTTP clients and message factories is needed. Avoid it when building monolithic applications with fixed HTTP client requirements (e.g., exclusively using Guzzle 7), as the abstraction adds unnecessary complexity. Do not use for projects lacking PSR compliance or where deterministic client selection is mandatory (e.g., security-critical systems requiring explicit configuration over auto-discovery).

How to Pitch It (Stakeholders)

Executives: "This package allows us to build future-proof, interoperable SDKs that work seamlessly with any modern PHP HTTP client—reducing customer onboarding friction and technical debt. By leveraging industry-standard discovery, we avoid locking users into specific implementations, which accelerates adoption and simplifies long-term maintenance."
Engineers: "It eliminates manual client selection logic in our SDKs, using PSR-17/PSR-18 standards to auto-detect available implementations. The Composer plugin can even auto-install missing dependencies, streamlining development and ensuring consistent behavior across environments. This is battle-tested in production by major PHP projects and reduces our codebase complexity by 30-50% for HTTP-related logic."