Mock Web Server
Simple, easy to use Mock Web Server for PHP unit testing. Gets along simply with PHPUnit and other unit testing frameworks.
Unit testing HTTP requests can be difficult, especially in cases where injecting a request library is difficult or not ideal. This helps greatly simplify the process.
Mock Web Server creates a local Web Server you can make predefined requests against.
Limitations
Unfortunately, Mock Web Server does not currently support Windows. While it may work in the Linux Subsystem, I do not have a copy of Windows 10 to experiment with.
I would be happy to accept pull requests that correct this.
Documentation
Requirements
- php: >=5.4
- ext-sockets: *
- ralouphie/getallheaders: ~2.0
Installing
Install the latest version with:
composer require --dev 'donatj/mock-webserver'
Examples
Basic Usage
The following example shows the most basic usage. If you do not define a path, the server will simply bounce a JSON body describing the request back to you.
<?php
use donatj\MockWebServer\MockWebServer;
require __DIR__ . '/../vendor/autoload.php';
$server = new MockWebServer;
$server->start();
$url = $server->getServerRoot() . '/endpoint?get=foobar';
echo "Requesting: $url\n\n";
echo file_get_contents($url);
Outputs:
Requesting: http://127.0.0.1:8123/endpoint?get=foobar
{
"_GET": {
"get": "foobar"
},
"_POST": [],
"_FILES": [],
"_COOKIE": [],
"HEADERS": {
"Host": "127.0.0.1:8123",
"Connection": "close"
},
"METHOD": "GET",
"INPUT": "",
"PARSED_INPUT": [],
"REQUEST_URI": "\/endpoint?get=foobar",
"PARSED_REQUEST_URI": {
"path": "\/endpoint",
"query": "get=foobar"
}
}
Simple
<?php
use donatj\MockWebServer\MockWebServer;
use donatj\MockWebServer\Response;
require __DIR__ . '/../vendor/autoload.php';
$server = new MockWebServer;
$server->start();
// We define the servers response to requests of the /definedPath endpoint
$url = $server->setResponseOfPath(
'/definedPath',
new Response(
'This is our http body response',
[ 'Cache-Control' => 'no-cache' ],
200
)
);
echo "Requesting: $url\n\n";
$content = file_get_contents($url);
// $http_response_header is a little known variable magically defined
// in the current scope by file_get_contents with the response headers
echo implode("\n", $http_response_header) . "\n\n";
echo $content . "\n";
Outputs:
Requesting: http://127.0.0.1:8123/definedPath
HTTP/1.0 200 OK
Host: 127.0.0.1:8123
Connection: close
X-Powered-By: PHP/5.6.30
Cache-Control: no-cache
Content-type: text/html; charset=UTF-8
This is our http body response
PHPUnit
<?php
use donatj\MockWebServer\MockWebServer;
use donatj\MockWebServer\Response;
class ExampleTest extends PHPUnit_Framework_TestCase {
/** @var MockWebServer */
protected static $server;
public static function setUpBeforeClass() {
self::$server = new MockWebServer;
self::$server->start();
}
public function testGetParams() {
$result = file_get_contents(self::$server->getServerRoot() . '/autoEndpoint?foo=bar');
$decoded = json_decode($result, true);
$this->assertSame('bar', $decoded['_GET']['foo']);
}
public function testGetSetPath() {
// $url = http://127.0.0.1:8123/definedEndPoint
$url = self::$server->setResponseOfPath('/definedEndPoint', new Response('foo bar content'));
$result = file_get_contents($url);
$this->assertSame('foo bar content', $result);
}
static function tearDownAfterClass() {
// stopping the web server during tear down allows us to reuse the port for later tests
self::$server->stop();
}
}
Multiple Responses to the Same Endpoint
If you need to test multiple, different responses to the same endpoint it supports that as well.
<?php
use donatj\MockWebServer\MockWebServer;
use donatj\MockWebServer\Response;
use donatj\MockWebServer\ResponseStack;
require __DIR__ . '/../vendor/autoload.php';
$server = new MockWebServer;
$server->start();
// We define the servers response to requests of the /definedPath endpoint
$url = $server->setResponseOfPath(
'/definedPath',
new ResponseStack(
new Response("Response One"),
new Response("Response Two")
)
);
echo "Requesting: $url\n\n";
$contentOne = file_get_contents($url);
$contentTwo = file_get_contents($url);
// This third request is expected to 404 which will error if errors are not ignored
$contentThree = file_get_contents($url, false, stream_context_create([ 'http' => [ 'ignore_errors' => true ] ]));
// $http_response_header is a little known variable magically defined
// in the current scope by file_get_contents with the response headers
echo $contentOne . "\n";
echo $contentTwo . "\n";
echo $contentThree . "\n";
Outputs:
Requesting: http://127.0.0.1:60515/definedPath
Response One
Response Two
Past the end of the Response Stack