Laravel quickstart

bash

composer require --dev "studio-design/gesso:^2.0"
php artisan vendor:publish --tag=gesso

Register the extension in phpunit.xml. This is what configures the spec loader for the runtime validator; gesso.spec_base_path in the published config/gesso.php does not — it only feeds the gesso:routes and gesso:stubs Artisan commands:

xml

<extensions>
    <bootstrap class="Studio\Gesso\PHPUnit\OpenApiCoverageExtension">
        <parameter name="spec_base_path" value="openapi"/>
        <parameter name="specs" value="petstore"/>
    </bootstrap>
</extensions>

Set default_spec to petstore, add ValidatesOpenApiSchema to your base test case, then assert a normal Laravel response:

php

$response = $this->getJson('/pets');
$response->assertOk();
$this->assertResponseMatchesOpenApiSchema($response);

The complete examples/laravel fixture installs and runs in CI:

bash

composer test

Its second test enables auto_assert and auto_validate_request, demonstrating validation without an explicit assertion. The PHPUnit extension prints coverage for both tests.

Already generating your spec with Scramble? Follow the Scramble integration recipe to validate generated contracts, cover 401/404/422 responses, and gate untested contract changes in CI.

Laravel quickstart ​

Laravel quickstart