naruepat/servicecurl

Laravel Service cURL

CURL for THiNKNET Web Service by Naruepat, _(*1)

Installation

Require this package in your composer.json and update composer. This will download the package, _(*2)

"naruepat/servicecurl": "dev-master"

or See https://packagist.org/packages/naruepat/servicecurl, _(*3)

After updating composer, add the ServiceProvider to the providers array in app/config/app.php, _(*4)

'Naruepat\Servicecurl\ServicecurlServiceProvider',

You can use the facade for shorter code. Add this to your aliases:, _(*5)

'ServicecURL' => 'Naruepat\Servicecurl\Facades\Servicecurl',

The class is bound to the ioC as ServicecURL, _(*6)

$post = ServicecURL::post('www.example.com/list');

or if config domain you can use path, _(*7)

$post = ServicecURL::post('list');

Configuration

First, from the command line again, run, _(*8)

For Laravel 4, _(*9)

php artisan config:publish naruepat/servicecurl

For Laravel 5, _(*10)

php artisan view:publish

to publish the default configuration file., _(*11)

Configuration was designed to be as flexible as possible., _(*12)

By default, global configuration can be set in the app/config/packages/naruepat/servicecurl/config.php file. If a configuration isn't set, then the package defaults from vendor/naruepat/servicecurl/src/config/config.php are used. Here is an example configuration, with all the default settings shown:, _(*13)

return array(
    'domain' => 'http://www.example.com/',
    'client_id' => '',
    'client_secret' => ''
);

Usage

 'value1']);

// easily build an url with a query string
$url = ServicecURL::buildUrl('http://www.example.com', ['s' => 'curl']);
$response = ServicecURL::get($url);

// post() takes an array of POST data
$url = ServicecURL::buildUrl('http://api.myservice.com', ['api_key' => 'my_api_key']);
$response = ServicecURL::post($url, ['post' => 'data']);

// add "json" to the start of the method to post as JSON
$response = ServicecURL::jsonPut($url, ['post' => 'data']);

// add "raw" to the start of the method to post raw data
$response = ServicecURL::rawPost($url, 'code; // response status code (for example, '200 OK')
echo $response->statusCode; // response status code (for example, 200)
echo $response->statusText; // response status text (for example, '200 OK')
echo $response->body;
var_dump($response->headers); // array of headers
var_dump($response->info); // array of curl info
?>

If you need to send headers or set cURL options you can manipulate a request object instead. send() finalizes the request and returns the result., _(*14)

<?php
// newRequest or newJsonRequest returns a Request object
$result = ServicecURL::newRequest('post', $url, ['foo' => 'bar'])
    ->setHeader('content-type', 'application/json')
    ->setHeader('Accept', 'json')
    ->setOptions([CURLOPT_VERBOSE => true])
    ->send();
?>