Deprecated
This repository is no longer being actively maintained. We encourage you to not use this code.
If you rely on this code you might want to fork the repository to keep your systems from breaking, if we remove this repository in the future., (*1)
LswGuzzleBundle
, (*2)
The LswGuzzleBundle adds Guzzle API call functionality to your Symfony2 application.
It is easy to use from the code and is aimed to have full debugging capabilities., (*3)
Read the LeaseWebLabs blog about LswGuzzleBundle, (*4)
Read the Guzzle documentation, (*5)
Guzzle API documentation, (*6)
Requirements
- PHP 5.3 with cURL support
- Symfony 2.3
Installation
Installation is broken down in the following steps:, (*7)
- Download LswGuzzleBundle using composer
- Enable the Bundle
- Make sure the cURL module in PHP is enabled
Step 1: Download LswGuzzleBundle using composer
Add LswGuzzleBundle in your composer.json:, (*8)
{
"require": {
"leaseweb/guzzle-bundle": "*",
...
}
}
Now tell composer to download the bundle by running the command:, (*9)
``` bash
$ php composer.phar update leaseweb/guzzle-bundle, (*10)
Composer will install the bundle to your project's `vendor/leaseweb` directory.
### Step 2: Enable the bundle
Enable the bundle in the kernel:
``` php
It should display that the option "cURL support" is set to "enabled"., (*11)
This package should work on a Windows installation as well provided the CURL support
is enabled in PHP., (*12)
Configuration
These is an example of Guzzle client based on a service description (including cURL options):, (*13)
lsw_guzzle:
clients:
test:
config:
json_objects: true
curl.options:
CURLOPT_CONNECTTIMEOUT: 10
CURLOPT_SSL_VERIFYPEER: false
CURLOPT_USERAGENT: "LeaseWeb API Caller"
CURLOPT_FOLLOWLOCATION: true
CURLOPT_SSLVERSION: 3
description:
baseUrl: "http://sf2testproject.dev"
operations:
test:
httpMethod: "GET"
uri: "/app_dev.php/demo/?a=b"
json:
httpMethod: "GET"
uri: "/app_dev.php/demo/json"
json_post:
httpMethod: "POST"
uri: "/app_dev.php/demo/{action}"
parameters:
testvalue:
location: xml
action:
location: uri
Usage
This is how to consume the described service commands:, (*14)
$response = $this->get('guzzle.test')->getCommand('test')->execute();
$response = $this->get('guzzle.test')->getCommand('json')->execute();
$response = $this->get('guzzle.test')->getCommand('json_post',array('action'=>'json','testvalue'=>666))->execute();
License
This bundle is under the MIT license., (*15)