zjango/curl

Laravel Package For cURL

Laravel-Curl

Laravel-Curl is an object-oriented wrapper of the PHP cURL extension., _(*1)

Installation

To install the package, simply add the following to your Laravel installation's composer.json file, _(*2)

"require": {
    "zjango/laracurl": "dev-master"  
},

In Laravel 5.0

Run the usual composer update to pull the files. Then, add the following Service Provider to your providers array in your config/app.php config., _(*3)

'providers' => array(
    ...
    'Zjango\Curl\CurlServiceProvider',
);

And finally add a new line to the aliases array:, _(*4)

        'Curl'  =>  'Zjango\Curl\Facades\Curl',

In Laravel 5.2

Run the usual composer update to pull the files. Then, add the following Service Provider to your providers array in your config/app.php config., _(*5)

'providers' => array(
    ...
    Zjango\Curl\CurlServiceProvider::class,
);

And finally add a new line to the aliases array:, _(*6)

        'Curl'  =>  Zjango\Curl\Facades\Curl::class,

Quick Start and Examples

Simple GET Request, _(*7)

    Curl::get('http://www.example.com/');

Easily Build URL With Query String Attached, _(*8)

    Curl::buildUrl('http://www.example.com/search', array(
        'q' => 'keyword',
    ));

Easily GET Request With Query String Attached, _(*9)

    Curl::get('http://www.example.com/search', array(
        'q' => 'keyword',
    ));

post() accepts array of POST data, _(*10)

    Curl::post('http://www.example.com/login/', array(
        'username' => 'myusername',
        'password' => 'mypassword',
    ));

Prefix 'json' to method to post as JSON //todo, _(*11)

Prefix 'raw' to method to post as JSON //todo, _(*12)

$curl = new Curl;
$curl->setBasicAuthentication('username', 'password');
$curl->setUserAgent('');
$curl->setReferrer('');
$curl->setHeader('X-Requested-With', 'XMLHttpRequest');
$curl->setCookie('key', 'value');
$curl->get('http://www.example.com/');
if ($curl->error) {
    echo $curl->error_code;
}
else {
    echo $curl->body;
}
var_dump($curl->request_headers);
var_dump($curl->response_headers);

$curl = new Curl;
$curl->setopt(CURLOPT_RETURNTRANSFER, TRUE);
$curl->setopt(CURLOPT_SSL_VERIFYPEER, FALSE);
$curl->get('https://encrypted.example.com/');

Curl::put('http://api.example.com/user/', array(
    'first_name' => 'Zach',
    'last_name' => 'Borboa',
));

Curl::patch('http://api.example.com/profile/', array(
    'image' => '@path/to/file.jpg',
));

Curl::delete('http://api.example.com/user/', array(
    'id' => '1234',
));

$curl->close();

The Response Object

The $response variable in above examples represents an object as well., _(*13)

// Return cURL and http status (bool)
$response->error

// Return cURL error or http error code
$response->error_code

// cURL error or http error message
$response->error_message

// curl error (bool)
$response->curl_error

// curl error code
$response->curl_error_code

// curl error message
$response->curl_error_message


// http error  (bool)
$response->http_error

// Response http status code
$response->http_status_code

// Response http error message
$response->http_error_message

// Request _cookies
$response->_cookies


// set _headers
$response->_headers

// Request request_headers
$response->request_headers

// Return Headers
$response->response_headers

// cURL Info
$response->info

// Response Body
$response->body