Improve example

Author: donatj

README.md

@@ -218,6 +218,66 @@ class ExampleTest extends PHPUnit_Framework_TestCase {
 }
 ```
 
+### Delayed Response Usage
+
+By default responses will happen instantly. If you're looking to test timeouts, the DelayedResponse response wrapper may be useful.
+
+```php
+<?php
+
+use donatj\MockWebServer\DelayedResponse;
+use donatj\MockWebServer\MockWebServer;
+use donatj\MockWebServer\Response;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$server = new MockWebServer;
+$server->start();
+
+$response = new Response(
+	'This is our http body response',
+	[ 'Cache-Control' => 'no-cache' ],
+	200
+);
+
+// Wrap the response in a DelayedResponse object, which will delay the response
+$delayedResponse = new DelayedResponse(
+	$response,
+	100000 // sets a delay of 100000 microseconds (.1 seconds) before returning the response
+);
+
+$realtimeUrl = $server->setResponseOfPath('/realtime', $response);
+$delayedUrl  = $server->setResponseOfPath('/delayed', $delayedResponse);
+
+echo "Requesting: $realtimeUrl\n\n";
+
+// This request will run as quickly as possible
+$start = microtime(true);
+file_get_contents($realtimeUrl);
+echo "Realtime Request took: " . (microtime(true) - $start) . " seconds\n\n";
+
+echo "Requesting: $delayedUrl\n\n";
+
+// The request will take the delayed time + the time it takes to make and transfer the request
+$start = microtime(true);
+file_get_contents($delayedUrl);
+echo "Delayed Request took: " . (microtime(true) - $start) . " seconds\n\n";
+
+```
+
+Outputs:
+
+```
+Requesting: http://127.0.0.1:61355/realtime
+
+Realtime Request took: 0.015669107437134 seconds
+
+Requesting: http://127.0.0.1:61355/delayed
+
+Delayed Request took: 0.10729098320007 seconds
+
+```
+
 ## Multiple Responses from the Same Endpoint
 
 ### Response Stack

example/delayed.php

@@ -16,14 +16,24 @@
 );
 
 // Wrap the response in a DelayedResponse object, which will delay the response
-$delay = new DelayedResponse(
+$delayedResponse = new DelayedResponse(
 	$response,
 	100000 // sets a delay of 100000 microseconds (.1 seconds) before returning the response
 );
 
-$url = $server->setResponseOfPath('/delayedPath', $delay);
+$realtimeUrl = $server->setResponseOfPath('/realtime', $response);
+$delayedUrl  = $server->setResponseOfPath('/delayed', $delayedResponse);
 
-echo "Requesting: $url\n\n";
+echo "Requesting: $realtimeUrl\n\n";
+
+// This request will run as quickly as possible
+$start = microtime(true);
+file_get_contents($realtimeUrl);
+echo "Realtime Request took: " . (microtime(true) - $start) . " seconds\n\n";
+
+echo "Requesting: $delayedUrl\n\n";
 
 // The request will take the delayed time + the time it takes to make and transfer the request
-$content = file_get_contents($url);
+$start = microtime(true);
+file_get_contents($delayedUrl);
+echo "Delayed Request took: " . (microtime(true) - $start) . " seconds\n\n";

mddoc.xml

@@ -65,6 +65,12 @@ There has been work [started to implement this](https://github.com/donatj/mock-w
 						<section title="PHPUnit">
 							<source name="example/phpunit.php" lang="php"/>
 						</section>
+						<section title="Delayed Response Usage">
+							<text><![CDATA[By default responses will happen instantly. If you're looking to test timeouts, the DelayedResponse response wrapper may be useful.]]></text>
+							<source name="example/delayed.php" lang="php"/>
+							<text>Outputs:</text>
+							<exec cmd="php example/delayed.php" format="code-block" />
+						</section>
 					</section>
 					<section title="Multiple Responses from the Same Endpoint">
 						<section title="Response Stack">