From 37d3d4cce5c476397def4867e343abaf6524eba4 Mon Sep 17 00:00:00 2001 From: Michael Wallner Date: Tue, 13 May 2014 17:14:16 +0200 Subject: [PATCH] some examples --- http/Client.md | 101 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 100 insertions(+), 1 deletion(-) diff --git a/http/Client.md b/http/Client.md index faacc44..64d7aa8 100644 --- a/http/Client.md +++ b/http/Client.md @@ -1,6 +1,105 @@ # class http\Client implements SplSubject, Countable -The HTTP client. +The HTTP client. The only driver currently supported is http\Client\Curl. + +## Examples: + +### Sending a simple GET request: + + "My Client/0.1"] + ); + $request->setOptions(["timeout"=>1]); + + $client = new http\Client; + $client->enqueue($request)->send(); + + // pop the last retrieved response + $response = $client->getResponse(); + printf("%s returned '%s' (%d)\n", + $response->getTransferInfo("effective_url"), + $response->getInfo(), + $response->getResponseCode() + ); + ?> + +#### Yields: + + http://localhost/ returned 'HTTP/1.1 200 OK' (200) + + +### Submitting a standard form: + + "application/x-www-form-urlencoded"] + ); + $request->getBody()->append(new http\QueryString([ + "user" => "mike", + "name" => "Michael Wallner" + ])); + + $client = new http\Client; + $client->setOptions(["ssl" => [ + "version" => http\Client\Curl\SSL_VERSION_TLSv1 + ]]); + $client->enqueue($request)->send(); + + // ask for the response for this specific request + $response = $client->getResponse($request); + printf("-> %s\n", $response->getInfo()); + + ?> + +#### Yields: + + -> HTTP/1.1 200 OK + + +### Submitting a multipart form: + + getBody()->addForm([ + "user" => "mike", + "name" => "Michael Wallner" + ], [ + [ + "name" => "image", + "type" => "image/jpeg", + "file" => "image.jpg" + ] + ]); + + $client = new http\Client; + $client->setOptions(["ssl" => [ + "version" => http\Client\Curl\SSL_VERSION_TLSv1 + ]]); + $client->enqueue($request)->send(); + + // ask for the response for this specific request + $response = $client->getResponse($request); + printf("-> %.2F kB\n @ %.2F Mbit", + .001 * $response->getTransferInfo("size_upload"), + .0000008 * $response->getTransferInfo("speed_upload") + ); + ?> + +#### Yields: + + -> 15.98 kB @ 6.77 Mbit + ## Properties: -- 2.30.2