metaer/curl-wrapper-bundle

Curl wrapper bundle

, _(*1)

Curl wrapper bundle

Curl Wrapper bundle for symfony framework
https://packagist.org/packages/metaer/curl-wrapper-bundle, _(*2)

Installation

``` sh composer require metaer/curl-wrapper-bundle, <sub>(*3)</sub>

If you use Symfony 4+ with symfony flex - that's all</br>
If you use Symfony 2 or 3 (without symfony flex), add to AppKernel.php:
``` php 
new \Metaer\CurlWrapperBundle\MetaerCurlWrapperBundle(),

Basic Usage

``` php $options = [ CURLOPT_URL => 'http://example.ex', CURLOPT_RETURNTRANSFER => true, ];, <sub>(*4)</sub>

$cw = $container->get('metaer_curl_wrapper.curl_wrapper');, <sub>(*5)</sub>

try { $result = $cw->getQueryResult($options); } catch (CurlWrapperException $e) { //handle exception }, <sub>(*6)</sub>

Basic usage with injection into your controller:
---
``` php
MyController {
    /**
     * @var CurlWrapper
     */
    private $curlWrapper;

    /**
     * MyController constructor.
     * @param CurlWrapper $curlWrapper
     */
    public function __construct(CurlWrapper $curlWrapper)
    {
        $this->curlWrapper = $curlWrapper;
    }

    public function myAction() {    
        $options = [
            CURLOPT_URL => 'http://example.ex',
            CURLOPT_RETURNTRANSFER => true,
        ];

        try {
            $this->curlWrapper->getQueryResult($options);
        } catch (CurlWrapperException $e) {
            //handle exception
        }

        return new Response('something');
    }
}

Basic usage with controllers action argument:

``` php MyController { public function myAction(CurlWrapper $curlWrapper) {
$options = [ CURLOPT_URL => 'http://example.ex', CURLOPT_RETURNTRANSFER => true, ];, <sub>(*7)</sub>

    try {
        $result = $curlWrapper->getQueryResult($options);
    } catch (CurlWrapperException $e) {
        //handle exception
    }

    return new Response('something');
}

}, <sub>(*8)</sub>

Basic Usage with autowire in another service:
---
``` php
<?php
namespace App\Service;

use Metaer\CurlWrapperBundle\CurlWrapper;
use Metaer\CurlWrapperBundle\CurlWrapperException;

class MyService
{
    /**
     * @var CurlWrapper
     */
    private $curlWrapper;

    /**
     * MyService constructor.
     * @param CurlWrapper $curlWrapper
     */
    public function __construct(CurlWrapper $curlWrapper)
    {
        $this->curlWrapper = $curlWrapper;
    }

    public function myMethod() {    
        $options = [
            CURLOPT_URL => 'http://example.ex',
            CURLOPT_RETURNTRANSFER => true,
        ];

        try {
            $result = $this->curlWrapper->getQueryResult($options);
        } catch (CurlWrapperException $e) {
            //handle exception
        }
    }
}

How simply change service behaviour or extend

Symfony-4 example ``` yaml, <sub>(*9)</sub>

config/packages/metaer_curl_wrapper.yaml

metaer_curl_wrapper: wrapper: custom_curl_wrapper, <sub>(*10)</sub>

``` yaml
# services.yaml
services:
    # your services
    #...

    custom_curl_wrapper:
        class: 'App\MyCurlWrapper'

``` php // src/MyCurlWrapper.php namespace App;, <sub>(*11)</sub>

use Metaer\CurlWrapperBundle\CurlWrapper;, <sub>(*12)</sub>

class MyCurlWrapper extends CurlWrapper { public function getQueryResult(array $curlOptions) { //your code here return 'something'; }, <sub>(*13)</sub>

public function myCustomMethod()
{
    //something else
}

}, <sub>(*14)</sub>

So, you do not need copy-paste full class code. Only methods which you want change.</br></br>
Another way to do the same thing:

``` yaml
# services.yaml
services:
    # your services
    #...

    metaer_curl_wrapper.curl_wrapper:
        class: 'App\MyCurlWrapper'

Timeouts settings

$connectionTimeout = 8; //seconds
$serverResponseTimeout = 20; //seconds

$options = [
    CURLOPT_CONNECTTIMEOUT => $connectionTimeout,
    CURLOPT_TIMEOUT => $serverResponseTimeout,
];

$cw->getQueryResult($options);

See also

You can also use methods, <sub>(*15)</sub>

CurlWrapper::getResponseBody
CurlWrapper::getRequestBody
CurlWrapper::getRequestUrl