Need help with curl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

418 Stars 182 Forks MIT License 42 Commits 14 Opened issues


A basic CURL wrapper for PHP

Services available


Need anything else?

Contributors list


A basic CURL wrapper for PHP (see for more information about the libcurl extension for PHP)


Click the

link above or
git clone git://



Simply require and initialize the

class like so:
require_once 'curl.php';
$curl = new Curl;

Performing a Request

The Curl object supports 5 types of requests: HEAD, GET, POST, PUT, and DELETE. You must specify a url to request and optionally specify an associative array or string of variables to send along with it.

$response = $curl->head($url, $vars = array());
$response = $curl->get($url, $vars = array()); # The Curl object will append the array of $vars to the $url as a query string
$response = $curl->post($url, $vars = array());
$response = $curl->put($url, $vars = array());
$response = $curl->delete($url, $vars = array());

To use a custom request methods, you can call the

$response = $curl->request('YOUR_CUSTOM_REQUEST_TYPE', $url, $vars = array());

All of the built in request methods like

simply wrap the
method. For example, the
method is implemented like:
function post($url, $vars = array()) {
    return $this->request('POST', $url, $vars);


$response = $curl->get('');

The Curl object will append '&some_variable=some_value' to the url

$response = $curl->get('', array('some_variable' => 'some_value'));

$response = $curl->post('', array('title' => 'Test', 'body' => 'This is a test'));

All requests return a CurlResponse object (see below) or false if an error occurred. You can access the error string with the


The CurlResponse Object

A normal CURL request will return the headers and the body in one response string. This class parses the two and places them into separate properties.

For example

$response = $curl->get('');
echo $response->body; # A string containing everything in the response except for the headers
print_r($response->headers); # An associative array containing the response headers

Which would display something like

Some more html...

Array ( [Http-Version] => 1.0 [Status-Code] => 200 [Status] => 200 OK [Cache-Control] => private [Content-Type] => text/html; charset=ISO-8859-1 [Date] => Wed, 07 May 2008 21:43:48 GMT [Server] => gws [Connection] => close )

The CurlResponse class defines the magic __toString() method which will return the response body, so

echo $response
is the same as
echo $response->body

Cookie Sessions

By default, cookies will be stored in a file called

. You can change this file's name by setting it like this
$curl->cookie_file = 'some_other_filename';

This allows you to maintain a session across requests

Basic Configuration Options

You can easily set the referer or user-agent

$curl->referer = '';
$curl->user_agent = 'some user agent string';

You may even set these headers manually if you wish (see below)

Setting Custom Headers

You can set custom headers to send with the request

$curl->headers['Host'] = 12.345.678.90;
$curl->headers['Some-Custom-Header'] = 'Some Custom Value';

Setting Custom CURL request options

By default, the

object will follow redirects. You can disable this by setting:
$curl->follow_redirects = false;

You can set/override many different options for CURL requests (see the curl_setopt documentation for a list of them)

# any of these will work
$curl->options['AUTOREFERER'] = true;
$curl->options['autoreferer'] = true;
$curl->options['CURLOPT_AUTOREFERER'] = true;
$curl->options['curlopt_autoreferer'] = true;


Uses ztest, simply download it to

(or anywhere else in your php include_path)

Then run



Problems, comments, and suggestions all welcome: [email protected]

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.