Add in usage examples

 * Simple HTTPS client
 * Lookup client IP via DoH

Author: lucasnetau

README.md

@@ -1,6 +1,6 @@
 # DNS over HTTPS client for ReactPHP
 
-Resolve DNS queries over HTTPS, provides secure DNS resolution over untrusted or shared networks (eg Serverless deployments) utilising standard HTTP queries.
+Resolve DNS queries over HTTPS, provides secure DNS resolution over untrusted or shared networks (eg Serverless deployments) utilising standard HTTPS queries.
 
 ## Requirements
 
@@ -14,6 +14,11 @@ You can add the library as project dependency using [Composer](https://getcompos
 composer require edgetelemetrics/reactphp-dns-over-https-client
 ```
 
+## Examples
+See [/examples](/examples) directory
+ * [Use DoH with ReactHTTP Client](/examples/browser.php)
+ * [Use DoH to find your public IP](/examples/whats-my-ip.php)
+
 ## License
 
 MIT, see [LICENSE file](LICENSE).

examples/browser.php

@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+use EdgeTelemetrics\React\Dns\DohExecutor;
+use React\Cache\ArrayCache;
+use React\Dns\Query\CachingExecutor;
+use React\Dns\Query\TimeoutExecutor;
+use React\Dns\Resolver\Resolver;
+
+include __DIR__ . '/../vendor/autoload.php';
+
+$cache = new ArrayCache(256);
+
+$executor = new TimeoutExecutor(
+    new DohExecutor('1.1.1.1'),
+    5.0,
+);
+$executor = new CachingExecutor($executor, $cache);
+
+$resolver = new Resolver($executor);
+
+$endpoint = 'https://raw.githubusercontent.com/lucasnetau/reactphp-dns-over-https-client/main/README.md';
+
+$client = (new React\Http\Browser(new React\Socket\Connector([
+    'tcp' => ['tcp_nodelay' => true,],
+    'dns' => $resolver,
+    'timeout' => 5.0,
+])))->withTimeout(10.0);
+
+$client->get($endpoint)->then(function (Psr\Http\Message\ResponseInterface $response) {
+    $body = (string)$response->getBody();
+    echo $body;
+}, 'printf');

examples/whats-my-ip.php

@@ -0,0 +1,20 @@
+<?php declare(strict_types=1);
+
+use EdgeTelemetrics\React\Dns\DohExecutor;
+use React\Dns\Query\TimeoutExecutor;
+use React\Dns\Resolver\Resolver;
+
+include __DIR__ . '/../vendor/autoload.php';
+
+$executor = new TimeoutExecutor(
+    new DohExecutor('doh.opendns.com'),
+    5.0,
+);
+
+$resolver = new Resolver($executor);
+
+$resolver->resolve('myip.opendns.com')->then(function($ip) {
+    echo 'Your IP is ' . $ip . PHP_EOL;
+}, 'printf');
+
+