rjr/curl

RuanJiaran-CURL class for PHP

v0.2 2018-11-01 05:45 UTC

Requires

• php: >=5.3.0
• ext-curl: *

Requires (Dev)

• phpunit/phpunit: 3.7.*
• squizlabs/php_codesniffer: ~2.1

MIT

• Ruan Jiaran

• curl
• rjr-curl

README

This library provides an object-oriented wrapper of the PHP cURL extension.

If you have questions or problems with installation or usage create an Issue.

Installation

In order to install this library via composer run the following command in the console:

composer require rjr/curl

or add the package manually to your composer.json file in the require section:

"rjr/curl": "^1.5"

Usage examples

$curl = new Rjr\Curl();
$curl->get('http://www.example.com/');

$curl = new Rjr\Curl();
$curl->get('http://www.example.com/search', array(
    'q' => 'keyword',
));

$curl = new Rjr\Curl();
$curl->post('http://www.example.com/login/', array(
    'username' => 'myusername',
    'password' => 'mypassword',
));

$curl = new Rjr\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->response;
}

var_dump($curl->request_headers);
var_dump($curl->response_headers);

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

$curl = new Rjr\Curl();
$curl->put('http://api.example.com/user/', array(
    'first_name' => 'Zach',
    'last_name' => 'Borboa',
));

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

$curl = new Rjr\Curl();
$curl->delete('http://api.example.com/user/', array(
    'id' => '1234',
));

$curl->close();

// Example access to curl object.
curl_set_opt($curl->curl, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1');
curl_close($curl->curl);

// Example of downloading a file or any other content
$curl = new Rjr\Curl();
// open the file where the request response should be written
$file_handle = fopen($target_file, 'w+');
// pass it to the curl resource
$curl->setOpt(CURLOPT_FILE, $file_handle);
// do any type of request
$curl->get('https://github.com');
// disable writing to file
$curl->setOpt(CURLOPT_FILE, null);
// close the file for writing
fclose($file_handle);

## Testing

In order to test the library:

1. Create a fork
2. Clone the fork to your machine
3. Install the depencies composer install
4. Run the unit tests ./vendor/bin/phpunit tests