README

The simplest OOP-style wrapper for the standard php curl functions with no external dependencies. 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(); $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(); $cm->init()`
`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(); $cs->init()`
`curl_share_close($h)`	`unset($cs)`
`$r = curl_multi_setopt($h, $opt, $val)`	`$r = $cs->setOpt($opt, $val)`

phpcurl / curlwrapper

Maintainers

Details