Allows to validate a controller response from your API project against a given OpenAPI specification.
You can use composer or simply download the release.
Composer
The preferred method is via composer. Follow the installation instructions if you do not already have composer installed.
Once composer is installed, execute the following command in your project root to install this library:
composer require radebatz/openapi-verifierAfter that all required classes should be availabe in your project to add routing support.
The VerifiesOpenApi trait can be used directly and customized in 3 ways in order to provide the reqired OpenApi specifications:
- Overriding the method
getOpenApiSpecificationLoader()as shown below - Populating the
$openapiSpecificationLoaderproperty. - Setting a property
$openapiSpecificationpointing to the specification file
<?php
namespace Tests\Feature;
use Radebatz\OpenApi\Verifier\VerifiesOpenApi;
use Radebatz\OpenApi\Verifier\OpenApiSpecificationLoader;
use PHPUnit\Framework\TestCase;
class UsersTest extends TestCase
{
use VerifiesOpenApi;
/** @inheritdoc */
protected function getOpenApiSpecificationLoader(): ?OpenApiSpecificationLoader
{
return new OpenApiSpecificationLoader(__DIR__ . '/specifications/users.yaml');
}
/** @test */
public function index()
{
// PSR client
$client = $this->client();
$response = $client->get('/users');
$this->assertEquals(200, $response->getStatusCode());
// will throw OpenApiSchemaMismatchException if verification fails
$this->verifyOpenApiResponseBody('get', '/users', 200, (string) $response->getBody());
}
}The adapter will try to resolve the specification dynamically in this order:
- filename passed into
registerOpenApiVerifier() /tests/openapi.json/tests/openapi.yaml- Generate specification from scratch by scanning the
appfolder
The code expects to be in the context of a Laravel Test\TestCase.
<?php
namespace Tests\Feature;
use Radebatz\OpenApi\Verifier\Adapters\Laravel\OpenApiResponseVerifier;
use Tests\TestCase;
class UsersTest extends TestCase
{
use OpenApiResponseVerifier;
public function setUp(): void
{
parent::setUp();
$this->registerOpenApiVerifier(/* $this->>createApplication() */ /* , [specification filename] */);
}
/** @test */
public function index()
{
// will `fail` if schema found and validation fails
$response = $this->get('/users');
$response->assertOk();
}
}The adapter will try to resolve the specification dynamically in this order:
- filename passed into
registerOpenApiVerifier() /tests/openapi.json/tests/openapi.yaml- Generate specification from scratch by scanning the
srcfolder
Simplest way is to register the verifier in the Tests\Functional\BaseTestCase.
Attention: In order to be able to resolve routes with placeholders (i.e. something like /user/{id}) it is required to register the verifier before the routing middleware.
<?php
namespace Tests\Functional;
use ...
use Radebatz\OpenApi\Verifier\Adapters\Slim\OpenApiResponseVerifier;
use PHPUnit\Framework\TestCase;
class BaseTestCase extends TestCase
{
use OpenApiResponseVerifier;
public function runApp($requestMethod, $requestUri, $requestData = null)
{
...
$app = new App();
// register OpenApi verifier
$this->registerOpenApiVerifier($app, __DIR__ . '/../specifications/users.yaml');
$app->addRoutingMiddleware();
// ...
}
}<?php
namespace Tests\Functional;
class UsersTest extends BaseTestCase
{
/** @test */
public function index()
{
// will `fail` if schema found and validation fails
$response = $this->runApp('GET', '/users');
$this->assertEquals(200, $response->getStatusCode());
}
}The openapi-verifier project is released under the MIT license.