# Gesso > Gesso provides framework-agnostic OpenAPI 3.0/3.1/3.2 contract testing for PHPUnit with endpoint coverage tracking. Each `.md` link below is the raw Markdown of a documentation page. The same pages, concatenated in this order, are at https://studio-design.github.io/gesso/3.x/llms-full.txt. ## Get started - [Overview](https://studio-design.github.io/gesso/3.x/): what Gesso is, what it validates, and how coverage tracking works. - [Core / PHPUnit](https://studio-design.github.io/gesso/3.x/quickstarts/core.md): validate a response with plain PHPUnit, no framework adapter. - [Laravel](https://studio-design.github.io/gesso/3.x/quickstarts/laravel.md): publish the config and assert responses with the `ValidatesOpenApiSchema` trait. - [Symfony](https://studio-design.github.io/gesso/3.x/quickstarts/symfony.md): register the PHPUnit extension and assert `WebTestCase` responses against a spec. - [Pest](https://studio-design.github.io/gesso/3.x/quickstarts/pest.md): use the `toMatchOpenApiResponseSchema()` expectation registered by the Pest plugin. ## Guides - [Doctor command](https://studio-design.github.io/gesso/3.x/doctor.md): preflight a local spec for load and enforcement problems before tests run. - [Violation baseline](https://studio-design.github.io/gesso/3.x/baseline.md): adopt contract testing on a legacy API by baselining existing violations and failing only on new ones. - [Coverage baseline](https://studio-design.github.io/gesso/3.x/coverage-baseline.md): commit the set of uncovered responses and fail on new ones by name, instead of maintaining a coverage percentage. - [Spec patch coverage gate](https://studio-design.github.io/gesso/3.x/coverage-gate.md): fail a pull request when it changes an operation that no test exercises. - [Test stub scaffolding](https://studio-design.github.io/gesso/3.x/stubs.md): generate PHPUnit test skeletons for the responses a coverage document reports as uncovered. - [PSR-7 validation](https://studio-design.github.io/gesso/3.x/psr7.md): validate PSR-7 requests and responses from any HTTP client or middleware. - [Laravel route parity](https://studio-design.github.io/gesso/3.x/laravel-route-parity.md): compare registered Laravel routes with spec operations to catch undocumented drift. - [Schema-driven fuzzing](https://studio-design.github.io/gesso/3.x/fuzzing.md): generate deterministic valid and invalid request cases from schemas, with replay tokens. - [Named contract checks](https://studio-design.github.io/gesso/3.x/contract-checks.md): probe protocol-level contract holes schema validation cannot see, with Schemathesis-style check names. - [SDK response round trips](https://studio-design.github.io/gesso/3.x/sdk-roundtrip.md): generate branch-complete valid response payloads and exercise generated SDK decode/encode fidelity. - [Symfony contract testing](https://studio-design.github.io/gesso/3.x/contract-testing-symfony.md): full guide to spec-driven provider-side contract testing in a Symfony application. - [Consumer-side contract testing](https://studio-design.github.io/gesso/3.x/consumer-side-contract-testing.md): fake an external API from its OpenAPI document in `Http::fake()` or `MockHttpClient`, so fakes fail when the provider spec changes. - [Spec-driven vs consumer-driven](https://studio-design.github.io/gesso/3.x/spec-driven-vs-consumer-driven.md): decision framework for choosing between spec-driven contract testing with Gesso and consumer-driven contract testing with Pact PHP. - [PHP OpenAPI validation FAQ](https://studio-design.github.io/gesso/3.x/php-openapi-validation-faq.md): direct answers to the questions engineers ask most often about validating a PHP API against an OpenAPI spec, with tool comparisons. ## Recipes - [GitHub Actions](https://studio-design.github.io/gesso/3.x/recipes/github-actions.md): publish the coverage report as a Step Summary and workflow artifact. - [Scramble + Laravel](https://studio-design.github.io/gesso/3.x/recipes/scramble.md): validate Laravel test responses against a Scramble-generated OpenAPI document. - [Fuzzing and drift checks](https://studio-design.github.io/gesso/3.x/recipes/advanced-validation.md): wire fuzzing, enum drift, and strict-required detection into CI jobs. - [Parallel test runners](https://studio-design.github.io/gesso/3.x/parallel.md): merge per-worker coverage sidecars from paratest or `pest --parallel`. ## Migration - [Prepare for Gesso 3.0](https://studio-design.github.io/gesso/3.x/migration/v3.md): removals in v3.0 and the v2.9 deprecation notices that announce each one. - [Prepare for Gesso 2.0](https://studio-design.github.io/gesso/3.x/migration/v2.md): staged path for the package rename and PHP namespace change. - [From other validators](https://studio-design.github.io/gesso/3.x/migration/from-other-validators.md): incremental migration from Spectator, league/openapi-psr7-validator, and osteel. - [Rewrite code with Rector](https://studio-design.github.io/gesso/3.x/migration/rector.md): Rector sets for the PHP side of the v2 to v3 upgrade and of a kirschbaum laravel-openapi-validator, Spectator, osteel, or league/openapi-psr7-validator migration. ## Reference - [Setup](https://studio-design.github.io/gesso/3.x/setup.md): end-to-end configuration, extension parameters, auto-validation, and per-test opt-out mechanisms. - [Shared configuration](https://studio-design.github.io/gesso/3.x/configuration.md): the `gesso.php` file that the PHPUnit extension and the Laravel service provider both read. - [CLI reference](https://studio-design.github.io/gesso/3.x/cli.md): rules every `gesso` subcommand shares — exit codes, `--format`, and `--output-file`. - [Failure codes](https://studio-design.github.io/gesso/3.x/failure-codes.md): every stable `GSO` failure code, what it means, how to fix it, and what not to do to silence it; `gesso explain ` prints the same entry. - [Coverage](https://studio-design.github.io/gesso/3.x/coverage.md): report formats, endpoint markers, and `(method, path, status, content-type)` coverage granularity. - [Supported features](https://studio-design.github.io/gesso/3.x/supported-features.md): what is validated, what is skipped, and known limitations per OpenAPI version. - [Conformance](https://studio-design.github.io/gesso/3.x/conformance.md): results against the JSON Schema Test Suite and the OpenAPI Initiative example documents, pinned by commit. - [API reference](https://studio-design.github.io/gesso/3.x/api-reference.md): public classes — validators, spec loader, explorer, and coverage tracker. - [Decision records](https://studio-design.github.io/gesso/3.x/adr/index.md): architecture decision records that shape what Gesso is. - [Versioning](https://studio-design.github.io/gesso/3.x/versioning.md): the v1.x compatibility policy and which symbols and formats it covers. ## Optional - [Source](https://github.com/studio-design/gesso) - [Packagist](https://packagist.org/packages/studio-design/gesso)