symfony/contracts

Health v2 · maintenance only

Adoption not part of the score

3927 stars · 19 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Symfony Contracts is a set of PHP interfaces, traits, and normative docblocks extracted from Symfony components, published as small per-domain packages. It lets developers type-hint against stable abstractions so their code works with any conforming implementation, Symfony's or otherwise.

Use cases

• decouple my PHP code from specific Symfony component implementations
• type-hint against interfaces so any compatible library can be swapped in
• build a PHP package that interoperates with Symfony components
• use autowiring-friendly interfaces for dependency injection
• declare which contracts my package implements via composer 'provide'
• find a PHP equivalent to PSRs with Symfony-backed semantics

When to choose

• you write framework-agnostic PHP libraries that should work with Symfony
• you want loose coupling and swappable implementations behind stable interfaces
• you build services meant to be injected via Symfony autowiring
• you need battle-tested abstractions with reference test suites

When to avoid

• you need concrete implementations rather than interfaces
• your project doesn't use Composer or PHP
• you only target PSR standards and don't need Symfony-specific semantics

Facets

library · maturity stable

middleware plugin-system developer-tools web-development backend developer-tools apis php cross-platform interfaces abstractions decoupling interoperability standards symfony composer loose-coupling type-hints service-container php

Member repositories

For agents

markdown · JSON · MCP: product_card(name="symfony/contracts")