Merge pull request #24 from clue-labs/http

Link to clue/reactphp-buzz for HTTP requests

Author: clue

README.md

@@ -39,6 +39,7 @@ existing higher-level protocol implementation.
   * [ProxyConnector](#proxyconnector)
     * [Plain TCP connections](#plain-tcp-connections)
     * [Secure TLS connections](#secure-tls-connections)
+    * [HTTP requests](#http-requests)
     * [Connection timeout](#connection-timeout)
     * [DNS resolution](#dns-resolution)
     * [Authentication](#authentication)
@@ -49,7 +50,7 @@ existing higher-level protocol implementation.
 * [License](#license)
 * [More](#more)
 
-### Quickstart example
+## Quickstart example
 
 The following example code demonstrates how this library can be used to send a
 secure HTTPS request to google.com through a local HTTP proxy server:
@@ -188,6 +189,15 @@ $connector->connect('tls://smtp.googlemail.com:465')->then(function (ConnectionI
 > Note how secure TLS connections are in fact entirely handled outside of
   this HTTP CONNECT client implementation.
 
+#### HTTP requests
+
+HTTP operates on a higher layer than this low-level HTTP CONNECT implementation.
+If you want to issue HTTP requests, you can add a dependency for
+[clue/reactphp-buzz](https://github.com/clue/reactphp-buzz).
+It can interact with this library by issuing all
+[HTTP requests through a HTTP CONNECT proxy server](https://github.com/clue/reactphp-buzz#http-proxy).
+This works for both plain HTTP and TLS-encrypted HTTPS requests.
+
 #### Connection timeout
 
 By default, the `ProxyConnector` does not implement any timeouts for establishing remote

examples/01-proxy-https.php

@@ -2,6 +2,9 @@
 
 // A simple example which requests https://google.com/ through an HTTP CONNECT proxy.
 // The proxy can be given as first argument and defaults to localhost:8080 otherwise.
+//
+// For illustration purposes only. If you want to send HTTP requests in a real
+// world project, take a look at https://github.com/clue/reactphp-buzz#http-proxy
 
 use Clue\React\HttpProxy\ProxyConnector;
 use React\Socket\Connector;

examples/02-optional-proxy-https.php

@@ -6,6 +6,9 @@
 // This example highlights how changing from direct connection to using a proxy
 // actually adds very little complexity and does not mess with your actual
 // network protocol otherwise.
+//
+// For illustration purposes only. If you want to send HTTP requests in a real
+// world project, take a look at https://github.com/clue/reactphp-buzz#http-proxy
 
 use Clue\React\HttpProxy\ProxyConnector;
 use React\Socket\Connector;