Skip to main content

PHP Swagger Test

Build Status Opensource ByJG GitHub source GitHub license GitHub release Scrutinizer Code Quality

A set of tools for testing your REST calls based on the OpenApi specification using PHPUnit. Currently, this library supports the OpenApi specifications 2.0 (formerly swagger) and 3.0. Some features like callbacks, links and references to external documents/objects weren't implemented.

PHP Swagger Test can help you to test your REST Api. You can use this tool both for Unit Tests or Functional Tests.

This tool reads a previously Swagger JSON file (not YAML) and enables you to test the request and response. You can use the tool "" for creating the JSON file when you are developing your rest API.

The ApiTestCase's assertion process is based on throwing exceptions if some validation or test failed.

Use cases for PHP Swagger test

You can use the Swagger Test library as:

Who is using this library?


composer require "byjg/swagger-test"


SPEC=swagger php -S tests/rest/app.php &
SPEC=openapi php -S tests/rest/app.php &


Please raise your issue on Github issue.


This project uses the byjg/webrequest component. It implements the PSR-7 specification, and a HttpClient / MockClient to do the requests. Check it out to get more information.


Open source ByJG