Package Data | |
---|---|
Maintainer Username: | Vinelab |
Maintainer Contact: | abed.halawi@vinelab.com (Abed Halawi) |
Package Create Date: | 2013-05-30 |
Package Last Update: | 2019-09-25 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-11-12 15:00:42 |
Package Statistics | |
---|---|
Total Downloads: | 282,275 |
Monthly Downloads: | 1,276 |
Daily Downloads: | 53 |
Total Stars: | 58 |
Total Watchers: | 13 |
Total Forks: | 30 |
Total Open Issues: | 6 |
A smart, simple and fault-tolerant HTTP client for sending and recieving JSON and XML.
composer require vinelab/http
// change this to point correctly according
// to your folder structure.
require './vendor/autoload.php';
use Vinelab\Http\Client as HttpClient;
$client = new HttpClient;
$response = $client->get('echo.jsontest.com/key/value/something/here');
var_dump($response->json());
Edit app.php and add 'Vinelab\Http\HttpServiceProvider',
to the 'providers'
array.
It will automatically alias itself as HttpClient so no need to alias it in your app.php, unless you would like to customize it - in that case edit your 'aliases' in app.php adding 'MyHttp' => 'Vinelab\Http\Facades\Client',
$response = HttpClient::get('http://example.org');
// raw content
$response->content();
$request = [
'url' => 'http://somehost.net/something',
'params' => [
'id' => '12350ME1D',
'lang' => 'en-us',
'format' => 'rss_200'
]
];
$response = HttpClient::get($request);
// raw content
$response->content();
// in case of json
$response->json();
// XML
$response->xml();
$request = [
'url' => 'http://somehost.net/somewhere',
'params' => [
'id' => '12350ME1D',
'lang' => 'en-us',
'format' => 'rss_200'
]
];
$response = HttpClient::post($request);
// raw content
$response->content();
// in case of json
$response->json();
// XML
$response->xml();
These options work with all requests.
You can set the timeout
option in order to specify the number of seconds that your request will fail, if not completed.
$request = [
'url' => 'http://somehost.net/somewhere',
'params' => [
'id' => '12350ME1D',
'lang' => 'en-us',
'format' => 'rss_200'
],
'timeout' => 10
];
$response = HttpClient::get([
'url' => 'http://somehost.net/somewhere',
'headers' => ['Connection: close', 'Authorization: some-secret-here']
]);
// The full headers payload
$response->headers();
$response = HttpClient::get([
'url' => 'http://somehost.net/somewhere',
'auth' => [
'username' => 'user',
'password' => 'pass'
],
'params' => [
'var1' => 'value1',
'var2' => 'value2'
]
]);
$response = HttpClient::get([
'url' => 'http://some.where.url',
'digest' => [
'username' => 'user',
'password' => 'pass'
],
'params' => [
'var1' => 'value1',
'var2' => 'value2'
]
]);
HttpClient::get(['version' => 1.1, 'url' => 'http://some.url']);
HttpClient::post(['url' => 'http://to.send.to', 'content' => 'Whatever content here may go!']);
The content passed in the content
key will be concatenated to the URL followed by a ?
HttpClient::get(['url' => 'http://my.url', 'content' => 'a=b&c=d']);
It is pretty much the same process with different HTTP Verbs. Supports
GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD
Fault tolerance allows the request to be re-issued when it fails (i.e. timeout). This is useful in cases such as Microservices: When a service is down and is being called by another service, with fault tolerance the request will be re-issued in the hopes of the destination service being up again.
Issue a fault-tolerant request by setting the tolerant
flag to true
in the request. Also, specify
the time it should wait until it tries again with timeUntilNextTry
(in seconds) and the number of tries
before it is considered a failure with triesUntilFailure
(in seconds).
$request = [
'url' => 'http://somehost.net/somewhere',
'params' => [
'id' => '12350ME1D',
'lang' => 'en-us',
'format' => 'rss_200'
],
'timeout' => 10
'tolerant' => true,
'timeUntilNextTry' => 1,
'triesUntilFailure' => 3
];
In case of timeout occurance, a HttpClientRequestFailedException
will be thrown.
IMPORTANT! Notice: In order to make use of fault tolerance option, you must specify the
timeout
parameter too.