README

#Laravel Service cURL

CURL for THiNKNET Web Service by Naruepat

##Installation

Require this package in your composer.json and update composer. This will download the package

"naruepat/servicecurl": "dev-master"

or See https://packagist.org/packages/naruepat/servicecurl

After updating composer, add the ServiceProvider to the providers array in app/config/app.php

'Naruepat\Servicecurl\ServicecurlServiceProvider',

You can use the facade for shorter code. Add this to your aliases:

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

The class is bound to the ioC as ServicecURL

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

or if config domain you can use path

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

Configuration

First, from the command line again, run

For Laravel 4

php artisan config:publish naruepat/servicecurl

For Laravel 5

php artisan view:publish

to publish the default configuration file.

Configuration was designed to be as flexible as possible.

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:

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

##Usage

<?php
// use http method get, post, put, patch, delete
$response = ServicecURL::get('http://www.example.com');
$response = ServicecURL::post('http://www.example.com', ['param1' => '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, '<?xml version...');

// a response object is returned
echo $response->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.

<?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();
?>

naruepat / servicecurl

Maintainers

Details

README

Configuration