Add examples

Author: clue

README.md

@@ -26,6 +26,8 @@ $dns->resolve('igor.io')->then(function ($ip) {
 $loop->run();
 ```
 
+See also the [first example](examples).
+
 Pending DNS queries can be cancelled by cancelling its pending promise like so:
 
 ```php
@@ -59,7 +61,11 @@ $loop->run();
 ```
 
 If the first call returns before the second, only one query will be executed.
-The second result will be served from cache.
+The second result will be served from an in memory cache.
+This is particularly useful for long running scripts where the same hostnames
+have to be looked up multiple times.
+
+See also the [third example](examples).
 
 ### Custom cache adapter
 

examples/01-one.php

@@ -0,0 +1,18 @@
+<?php
+
+use React\Dns\Resolver\Factory;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = React\EventLoop\Factory::create();
+
+$factory = new Factory();
+$resolver = $factory->create('8.8.8.8', $loop);
+
+$name = isset($argv[1]) ? $argv[1] : 'www.google.com';
+
+$resolver->resolve($name)->then(function ($ip) use ($name) {
+    echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+}, 'printf');
+
+$loop->run();

examples/02-concurrent.php

@@ -0,0 +1,23 @@
+<?php
+
+use React\Dns\Resolver\Factory;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = React\EventLoop\Factory::create();
+
+$factory = new Factory();
+$resolver = $factory->create('8.8.8.8', $loop);
+
+$names = array_slice($argv, 1);
+if (!$names) {
+    $names = array('google.com', 'www.google.com', 'gmail.com');
+}
+
+foreach ($names as $name) {
+    $resolver->resolve($name)->then(function ($ip) use ($name) {
+        echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+    }, 'printf');
+}
+
+$loop->run();

examples/03-cached.php

@@ -0,0 +1,36 @@
+<?php
+
+use React\Dns\Resolver\Factory;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = React\EventLoop\Factory::create();
+
+$factory = new Factory();
+$resolver = $factory->createCached('8.8.8.8', $loop);
+
+$name = isset($argv[1]) ? $argv[1] : 'www.google.com';
+
+$resolver->resolve($name)->then(function ($ip) use ($name) {
+    echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+}, 'printf');
+
+$loop->addTimer(1.0, function() use ($name, $resolver) {
+    $resolver->resolve($name)->then(function ($ip) use ($name) {
+        echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+    }, 'printf');
+});
+
+$loop->addTimer(2.0, function() use ($name, $resolver) {
+    $resolver->resolve($name)->then(function ($ip) use ($name) {
+        echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+    }, 'printf');
+});
+
+$loop->addTimer(3.0, function() use ($name, $resolver) {
+    $resolver->resolve($name)->then(function ($ip) use ($name) {
+        echo 'IP for ' . $name . ': ' . $ip . PHP_EOL;
+    }, 'printf');
+});
+
+$loop->run();