weidizhang/php-curl-wrapper

A wrapper for cURL that makes it easy to use/manage requests and responses.

PHP-Curl-Wrapper

Created by Weidi Zhang, _(*1)

About

Easily make HTTP requests and get response information with cURL., _(*2)

Installation

composer require weidizhang/php-curl-wrapper:dev-master

Usage

First, require the autoloader and use the Curl class., _(*3)

require "vendor/autoload.php";
use weidizhang\PHPCurlWrapper\Curl;

Create a new Curl object, _(*4)

$curl = new Curl();

Changing default behavior

use weidizhang\PHPCurlWrapper\Behavior;

$curl->setBehavior( ... );

Options: KEEP_HEADERS, CLEAR_HEADERS., _(*5)

See src/Behavior.php to see what these do., _(*6)

Default: CLEAR_HEADERS, _(*7)

Setting various cURL options

$curl->setReferer( ... );
$curl->setUserAgent( ... );
$curl->setHeader( name, value );
$curl->setHeaders( array(
    "Header1: value1",
    "Header2: value2"
) );
$curl->unsetHeader( name );
$curl->setCookieFile( filename or path );
$curl->enableSSLVerify();
$curl->disableSSLVerify();

Setting custom cURL options

You can pass in the option either as a constant or string., _(*8)

All these do the same thing:, _(*9)

$curl->setOption(CURLOPT_FRESH_CONNECT, true);
$curl->setOption("CURLOPT_FRESH_CONNECT", true);
$curl->setOption("FRESH_CONNECT", true);

Making a request

$response = $curl->request( type, url, query [optional], options [optional] );

type = GET, POST, HEAD, PUT, etc. Custom request types are supported., _(*10)

url = URL., _(*11)

query = Query to send, it can be an array or string., _(*12)

options = An array of curl options to set. It calls $curl->setOption( ... ); for them., _(*13)

Getting cURL handle

If you need access to the cURL handle for whatever reason:, _(*14)

$curl->getHandle();

Handling the response

Getting body data: (Both work), _(*15)

$body = $response;
$body = $response->getBody();

Getting cURL request information:, _(*16)

$info = $response->getInfo();

Getting all headers:, _(*17)

$headers = $response->getHeaders();

Getting a specific header:, _(*18)

$header = $response->getHeader( name );

Checking for errors (Usually not necessary):, _(*19)

if ($response->hasError()) {
    $error = $response->getError();
}

License

Please read LICENSE.md to learn about what you can and cannot do with this source code., _(*20)