The GuzzleHttpBundle provide a guzzle client as symfony service.
Require the bundle in your composer.json file :
{
"require": {
"m6web/guzzle-http-bundle": "~1.0",
}
}Register the bundle in your kernel :
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
new M6Web\Bundle\GuzzleHttpBundle\M6WebGuzzleHttpBundle()
);
}Then install the bundle :
$ composer update m6web/guzzle-http-bundleAdd the m6web_guzzlehttp section in your configuration file. Here is the minimal configuration required.
# app/config/config.yml
m6web_guzzlehttp:
clients:
default: ~
other:
base_uri: "http://domain.tld/"All subkey under clients defines an instance of guzzle http client. These services are named m6web_guzzlehttp_+subkey expect for the
default subkey that define the main service m6web_guzzlehttp.
Then you can ask container for your client :
// in a controller
$client = $this->get('m6web_guzzlehttp'); // default client
try {
$response = $client->get('http://domain.tld/path/to/resource');
$promises = [
'first' => $client->getAsync('http://domain.tld/path/to/resource'),
'second' => $client->getAsync('http://domain.tld/path/to/other/resource')
];
$result = \GuzzleHttp\Promise\unwrap($promises);
} catch(\GuzzleHttp\Exception\ConnectException $e) {
// connection problem like timeout
}
// use other client
$otherClient = $this->get('m6web_guzzlehttp_other');
$response = $otherClient->get('path/to/resource'); // call http://domain.tld/path/to/resourceThe service return a configured guzzle client, for more information on how to use it, you can read the guzzle6 documentation.
The only difference with guzzle6 reside in usage of curl for the redirect responses. You can choose to have the guzzle behavior
for redirection by setting the configuration key redirect_handler to guzzle.
When a cache system is available, you can use force_cache and cache_ttl in addition of guzzle options than respectively
force clear cache before request and use a specific ttl to a request that override configuration.
$client = $this->get('m6web_guzzlehttp');
$response = $client->get('http://domain.tld', ['force_cache' => true]); // remove cache entry and set a new one
$response = $client->get('http://doamin.tld/path', ['cache_ttl' => 200]); // set ttl to 200 seconds instead the default oneDatacollector is available when the symfony profiler is enabled. The collector allows you to see the following data :
- Method
- Url
- Response code and reason
- Execution time
- Redirect count
- Redirect time
- Cache hit
- Cache ttl
NOTE : If you choose guzzle for redirect_handler, The redirect count and redirect time will always set to zero.
Cache informations are available when a cache system is set.
You can set a cache for request by adding in the config the guzzlehttp_cache with service subkey who is a reference
to a service implementing M6Web\Bundle\GuzzleHttpBundle\Cache\CacheInterface
# app/config/config.yml
m6web_guzzlehttp:
clients:
default:
base_uri: "http://domain.tld/"
guzzlehttp_cache:
service: my_cache_serviceWe provide an "In memory" cache class that you can use by defining a new cache service and use it in Guzzle configuration :
# app/config/config.yml
services:
company.guzzle.cache.inmemory:
class: M6Web\Bundle\GuzzleHttpBundle\Cache\InMemory
m6web_guzzlehttp:
clients:
default:
guzzlehttp_cache:
service: company.guzzle.cache.inmemoryWe also provide a cache interface for Redis with our RedisBundle >= 2.4, than you can use in this way:
# app/config/config.yml
m6web_guzzlehttp:
clients:
default:
base_uri: "http://domain.tld/"
guzzlehttp_cache:
service: m6_redis.guzzlehttp
m6_redis:
servers:
default:
ip: '127.0.0.1'
port: 6379
clients:
guzzlehttp:
servers: ["default"] # list of servers to use
namespace: GuzzleHttp\
timeout: 2 # timeout in second
readwritetimeout: 2 # read-write timeout in second
class: M6Web\Bundle\RedisBundle\CacheAdapters\M6WebGuzzleHttp
For more information on how to setup the RedisBundle, refer to the README in the project.
m6web_guzzlehttp:
clients:
default:
base_uri: "" # Base uri to prepend on request uri
timeout: 5.0 # request timeout
http_errors: true # enable or disable exception on http errors
allow_redirects: true # enable or disable follow redirect
redirect_handler: curl # guzzle or curl
proxy: proxy:port # Optional. Set the proxy for client.
redirects:
max: 5 # Maximum redirect to follow
strict: false # use "strict" RFC compliant redirects. (guzzle redirect handler only)
referer: true # add a Referer header
protocols: ["http", "https"] # restrict redirect to a protocol
guzzlehttp_cache: # optional cache
service: my_cache_service # reference to service who implements the cache interface
default_ttl: 3600 # defautl ttl for cache entry in seconds
use_header_ttl: false # use the cache-control header to set the ttl
default_headers: # optionnal. Default request headers
User_Agent: "m6web/1.0" # set header "User-Agent" with the value "m6web/1.0"
header\_name: "my value" # set header "header_name" with value "my value"
otherclient:
...For the default_headers options, the key in array represent the header name. The underscore will be transformed to hyphen
except if is escaped by a backslash.
First of all, thank you for contributing !
Here are few rules to follow for a easier code review before the maintainers accept and merge your request.
- you MUST follow the Symfony2 coding standard : you can use
./bin/coketo validate - you MUST run the test
- you MUST write or update tests
- you MUST write or update documentation
Install the composer dev dependencies
$ composer install --devThen run the test with atoum unit test framework
./bin/atoum