bigfoot90/phpacto

Contract testing tool integrated with Guzzle and Phpunit

PHPacto

Contract testing solution for your API's and microservices, _(*1)

If you want to know more about Contract Testing please read more here and here., _(*2)

, _(*3)

, _(*4)

DISCLAIMER: This is a work in progress. The code can be subject to any changes without BC until the release version 1.0.0. Please use the issue tracker to report any enhancements or issues you encounter., _(*5)

You can find some contract examples in examples directory., _(*6)

Usage standalone CLI

First of all clone this repository git clone git@github.com:PHPacto/PHPacto.git and install vendors with composer composer install., _(*7)

Validate

Validate your contracts with, _(*8)

bin/phpacto validate path-to/directory-or-single-file

cURL command generator

Generate cURL commands from contracts with, _(*9)

bin/phpacto curl path-to/directory-or-single-file

SUGGESTION: Can use phpdotenv to load environment variables from file., _(*10)

Usage with Docker

Validate

Validate your contracts with, _(*11)

docker run -it --rm \
    -v $PWD/contracts:/srv/data \
    -e CONTRACTS_DIR=data \
    -p 8000:8000 \
    phpacto/mock-server \
    validate

cURL command generator

Generate cURL commands from contracts with, _(*12)

docker run -it --rm \
    -v $PWD/contracts:/srv/data \
    -e CONTRACTS_DIR=data \
    -p 8000:8000 \
    phpacto/mock-server \
    curl

Server Mock

See https://github.com/PHPacto/mock-server, _(*13)

Mock Proxy Recorder

See https://github.com/PHPacto/recorder, _(*14)

Testing your application

Compatibility table , _(*15)

If your project satisfies these requirements, you can run composer require --dev bigfoot90/phpacto and test your contracts with phpunit, else you need to run contracts testing with PHPacto's CLI wich is slower but works with any kind of application., _(*16)

Integration with PHPUnit

If your test ends with too much verbose tracelog maybe your TestCase is not extending from Bigfoot\PHPacto\Test\PHPUnit\PHPactoTestCase, so add this line in your setUp method:, _(*17)

PHPUnit\Util\Blacklist\Blacklist::$blacklistedClassNames[__CLASS__] = 1;

See this Gist https://gist.github.com/bigfoot90/d4f146bacad359329d219a804f6cd12a There are two different test files ConsumerTest.php and ProviderTest.php, _(*18)

Mastering with PHPacto contract Rules

Read the dedicated page here, _(*19)

Contributing

Feel free to contribute by opening a pull request. Bug fixes or feature suggestions are always welcome., _(*20)