digitalzenworks / api-test
A library for end to end testing web APIs with PHPUnit.
Fund package maintenance!
jamesjohnmcguire
Requires
- php-http/guzzle7-adapter: ^1.0
- phpunit/phpunit: ^11.0 || ^12.0
Requires (Dev)
README
A library for testing web APIs with PHPUnit.
Please ⭐ star this project!
Getting Started
Requirements/dependencies
This requirement could potentially be relaxed to older version of PHP upon request.
Installation
Git
git clone https://github.com/jamesjohnmcguire/ApiTest
Composer
composer require --dev https://packagist.org/packages/digitalzenworks/api-test
Usage:
API Testing
There is one main class with one main method. You can call it like this:
require_once 'vendor/autoload.php'; use DigitalZenWorks\ApiTest\ApiTester; final class UnitTests extends TestCase { #[Test] public function ApiEndPointPostSuccess() { $data = [ 'name' => 'Somebody', 'email' => 'Somebody@example.com' ]; $apiTester = new APITester('https://httpbin.org'); $response = $this->apiTester->apiEndPointTest('POST', 'post', $data); $this->assertIsArray($response); } )
The main method parameters are:
Type: | Parameter: |
---|---|
string | The HTTP method to use. |
string | The API end point. |
?string | The request data. |
bool or string | The data type. True, if it is multipart |
form data. Implying some of the data may | |
be binary. If it is false, it will then be | |
of the 'form_params' type. If it is a | |
string, the string indicates the type of | |
data ('body', 'json', 'form_params', | |
'query', 'form_params'). |
Page or End-to-End Testing
This also supports testing HTML pages directly. You can call it like this:
require_once 'vendor/autoload.php'; use DigitalZenWorks\ApiTest\PageTester; final class UnitTests extends TestCase { #[Test] public function SimplePage() { PageTester $pageTester = new PageTester('https://httpbin.org', 'text/html', 'text/html'); $endPoint = 'https://httpbin.org/get'; $content = $this->TestSitePage($endPoint); $this->assertNotNull($content); $this->assertNotEmpty($content); $this->assertStringContainsStringIgnoringCase( '<!DOCTYPE html>', $content); } }
Additional Notes
This uses Guzzle to process the API request.
Guzzle Response Object
You can access the Guzzle response object by accessing the public $response property of PageTester. like:
$response = $pageTester->response;
$status = $response->getStatusCode();
$this->assertEquals(200, $status);
Note: Status is already checked within TestSitePage. It's just included here for the purposes of example.
Guzzle History Object
You can also access the Guzzle history (handler) object by accessing the public $response property of PageTester. like:
$history = $pageTester->history;
$redirects = count($history) - 1;
$this->assertEquals(1, $redirects);
This can be useful for tracking redirects, among other things.
Contributing
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Process:
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Coding style
Please match the current coding style. Most notably:
- One operation per line
- Use complete English words in variable and method names
- Attempt to declare variable and method names in a self-documenting manner
License
Distributed under the MIT License. See LICENSE
for more information.
Contact
James John McGuire - @jamesmc - jamesjohnmcguire@gmail.com
Project Link: https://github.com/jamesjohnmcguire/ApiTest