Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/byjg/php-swagger-test

A set of tools for testing your REST calls based on the swagger documentation using PHPUnit
https://github.com/byjg/php-swagger-test

hacktoberfest php phpunit swagger

Last synced: 7 days ago
JSON representation

A set of tools for testing your REST calls based on the swagger documentation using PHPUnit

Host: GitHub
URL: https://github.com/byjg/php-swagger-test
Owner: byjg
License: mit
Created: 2017-05-22T17:06:34.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-11-30T21:41:22.000Z (2 months ago)
Last Synced: 2025-01-25T17:02:41.344Z (14 days ago)
Topics: hacktoberfest, php, phpunit, swagger
Language: PHP
Homepage:
Size: 352 KB
Stars: 100
Watchers: 6
Forks: 33
Open Issues: 15
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # PHP Swagger Test

[![Build Status](https://github.com/byjg/php-swagger-test/actions/workflows/phpunit.yml/badge.svg?branch=master)](https://github.com/byjg/php-swagger-test/actions/workflows/phpunit.yml)

[![Opensource ByJG](https://img.shields.io/badge/opensource-byjg-success.svg)](http://opensource.byjg.com)

[![GitHub source](https://img.shields.io/badge/Github-source-informational?logo=github)](https://github.com/byjg/php-swagger-test/)

[![GitHub license](https://img.shields.io/github/license/byjg/php-swagger-test.svg)](https://opensource.byjg.com/opensource/licensing.html)

[![GitHub release](https://img.shields.io/github/release/byjg/php-swagger-test.svg)](https://github.com/byjg/php-swagger-test/releases/)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/byjg/php-swagger-test/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/byjg/php-swagger-test/?branch=master)

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 "[https://github.com/zircote/swagger-php](https://github.com/zircote/swagger-php)" 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:

- [Functional test cases](docs/functional-tests.md)

- [Contract test cases](docs/contract-tests.md)

- [Runtime parameters validator](docs/runtime-parameters-validator.md)

- [Mocking Requests and Validate your specification](docs/mock-requests.md)

Who is using this library?

- [ByJG PHP Rest Reference Architecture](https://github.com/byjg/php-rest-reference-architecture)

- [Laravel Swagger Test](https://github.com/pionl/laravel-swagger-test)

## Install

```bash

composer require "byjg/swagger-test"

```

## Tests

```bash

SPEC=swagger php -S 127.0.0.1:8080 tests/rest/app.php &

SPEC=openapi php -S 127.0.0.1:8081 tests/rest/app.php &

vendor/bin/phpunit

```

## Questions?

Please raise your issue on [Github issue](https://github.com/byjg/php-swagger-test/issues).

## References

This project uses the [byjg/webrequest](https://github.com/byjg/webrequest) component.

It implements the PSR-7 specification, and a HttpClient / MockClient to do the requests.

Check it out to get more information.

## Dependencies

```mermaid

flowchart TD

    byjg/swagger-test --> byjg/webrequest

```

----

[Open source ByJG](http://opensource.byjg.com)