CurlWrapper for PHP

The simplest OOP-style wrapper for the standard php curl functions. The main purpose is to make code that uses curl calls testable. We do it by injecting the Curl object as a dependency instead of calling curl functions directly.

Hard-coded dependencies. Not testable.

class MyApiClient {
    ...
    function call($url)
    {
        $ch = curl_init($url);
        curl_set_opt($ch, /*...*/)
        return curl_exec($ch);
    }
}

Testable code. Curl object is injected, so can be easily mocked in PHPUnit.

class MyApiClient {
    private $curl;
    function __construct(\PHPCurl\CurlWrapper\CurlInterface $curl)
    {
        $this->curl = $curl;
    }
    //...
    function call($url)
    {
        $this->curl->init($url);
        $this->curl->setOpt(/*...*/)
        return $this->curl->exec();
    }
}

Install

Via composer: $ composer require "phpcurl/curlwrapper"

Basic usage examples. Classic vs OOP style

Curl

Classic	OOP
$h = curl_init($url)	$curl = new Curl($url) or $curl->init($url)
curl_close($h)	unset($curl)
$e = curl_errno($h)	$e = $curl->errno()
$e = curl_error($h)	$e = $curl->error()
$i = curl_getinfo($h, $opt)	$i = $curl->getInfo($opt)
curl_setopt($h, $opt, $val)	$curl->setOpt($opt, $val)
curl_setopt_array($h, $array)	$curl->setOptArray($array)
curl_version($age)	$curl->version($age)
curl_strerror($errornum)	$curl->strerror($errornum)
$h2 = curl_copy_handle($h)	$curl2 = clone($curl)
$result = curl_exec($h)	$result = $curl->exec()
$res = curl_pause($h, $mask)	$res = $curl->pause($mask)
$res = curl_escape($h, $str)	$res = $curl->escape($str)
$res = curl_unescape($h, $str)	$res = $curl->unescape($str)

CurlMulti

Classic	OOP
curl_multi_init()	$cm = new CurlMulti()
curl_multi_close($h)	unset($cm)
$i = curl_multi_add_handle($mh, $ch)	$i = $cm->add($curl)
$i = curl_multi_remove_handle($mh, $ch)	$i = $cm->remove($curl)
$i = curl_multi_exec($mh, $running)	$i = $cm->exec($running)
$s = curl_multi_getcontent($ch)	$s = $cm->getContent($curl)
$a = curl_multi_info_read($mh, $msgs)	$a = $cm->infoRead($msgs)
$i = curl_multi_select($mh, $timeout)	$i = $cm->select($timeout)
$r = curl_multi_setopt($h, $opt, $val)	$r = $cm->setOpt($opt, $val)

CurlShare

Classic	OOP
curl_share_init()	$cs = new CurlShare()
curl_share_close($h)	unset($cs)
$r = curl_multi_setopt($h, $opt, $val)	$r = $cs->setOpt($opt, $val)