dcarbone / curl-plus
Object wrapper for PHP's CURL Library
Installs: 43 538
Dependents: 2
Suggesters: 0
Security: 0
Stars: 22
Watchers: 3
Forks: 2
Open Issues: 0
Requires
- php: >=8.0
- ext-curl: *
- dcarbone/curl-header-extractor: 2.0.*
Requires (Dev)
- phpunit/phpunit: ^8.0 || ^9.0
README
A simple wrapper around PHP's cURL implementation. It does not do anything magical, and is intended to be as simple as possible
Installation
This lib is designed to be used with Composer
"require" entry:
{ "dcarbone/curl-plus" : "4.0.*" }
CurlPlus Helper
To make executing and retrieving data from HTTP requests easier, I have created the CURL helper class.
Helper Basics:
All of the methods present below have a few default CURL options set, that you can override if needed:
- With the exception of HEAD and OPTIONS requests, all methods set
CURLOPT_RETURNTRANSFER
to true by default. - ALL methods set
CURLOPT_FOLLOWLOCATION
to true by default. - POST, PUT, and DELETE requests specify a default Request Content-Type header value of
application/x-www-form-urlencoded
- POST, PUT, and DELETE requests allow specification of a request body. This may either be a string, or associative array of "param" => "value", or an object. It will be turned into a string utilizing http_build_query.
- ALL methods return an instance CurlPlusResponse
- ALL methods allow overriding of CURLOPT and Request Header values used via optional array arguments. These will be merged with the defaults, with user-specified values receiving preference.
Usage Basics
This class is as close as PHP gets to a "static" class. It is abstract, and therefore cannot be instantiated on its own, and is intended to be used as such:
use DCarbone\CurlPlus\CURL; $response = CURL::get('http://www.gstatic.com/hostedimg/6ce955e0e2197bb6_large'); $image = imagecreatefromstring((string)$response); header('Content-Type: image/jpeg'); imagepng($image); imagedestroy($image);
The above will download photographic evidence of life saving tamales and output the image.
Check out the source of CURL to get a better look at all available methods and arguments.
Using the client directly
The most simple implementation of this class would be something like the following:
use DCarbone\CurlPlus\CURL; $client = new CurlPlusClient( 'http://my-url.etc/api', array( CURLOPT_RETURNTRANSFER => true, )); // Returns \DCarbone\CurlPlus\CurlPlusResponse object $response = $client->execute(); echo $response->responseBody."\n"; var_dump($response->responseHeaders); var_dump($response->error);
The above will simply execute a GET request and store the response in memory, rather than in the output buffer.
Constructor
The CurlPlusClient constructor takes 3 optional arguments:
- $url - string, the query endpoint
- $curlOpts - array, set of CURLOPT_ values
- $requestHeaders - array, associative array of $param=>$value strings that will be sent in the request
These are all optional parameters.
Note: If you set both the $url and CURLOPT_URL properties on construction, the constructor will use to the CURLOPT_URL value.
As stated above, all of those are optional arguments. You may simply construct the object with no params if you wish.
Post-construct, the methods:
// Set the URL you wish to query against, additionally you may also reset any existing curl opts public function initialize($url, $reset = true) {} // Accepts any options seen here: http://www.php.net//manual/en/function.curl-setopt.php public function setCurlOpt($opt, $val) {} // Accepts an associative array of Curl Opts public function setCurlOpts(array $array) {}
...will probably be the ones you use the most often.
Check out the CurlPlusClient source for more information.