2017 © Pedro Peláez
 

library curl-plus

Object wrapper for PHP's CURL Library

image

dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  • Thursday, September 22, 2016
  • by dcarbone
  • Repository
  • 2 Watchers
  • 24 Stars
  • 2,787 Installations
  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 29 Versions
  • 47 % Grown

The README.md

curl-plus

A simple wrapper around PHP's cURL implementation. It does not do anything magical, and is intended to be as simple as possible, (*1)

Tests, (*2)

Installation

This lib is designed to be used with Composer, (*3)

"require" entry:, (*4)

{
    "dcarbone/curl-plus" : "4.0.*"
}

CurlPlus Helper

To make executing and retrieving data from HTTP requests easier, I have created the CURL helper class., (*5)

Helper Basics:

All of the methods present below have a few default CURL options set, that you can override if needed:, (*6)

  • 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:, (*7)

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., (*8)

Check out the source of CURL to get a better look at all available methods and arguments., (*9)

Using the client directly

The most simple implementation of this class would be something like the following:, (*10)

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., (*11)

Constructor

The CurlPlusClient constructor takes 3 optional arguments:, (*12)

  • $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., (*13)

Note: If you set both the $url and CURLOPT_URL properties on construction, the constructor will use to the CURLOPT_URL value., (*14)

As stated above, all of those are optional arguments. You may simply construct the object with no params if you wish., (*15)

Post-construct, the methods:, (*16)

// 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., (*17)

Check out the CurlPlusClient source for more information., (*18)

The Versions

22/09 2016

dev-master

9999999-dev https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

Apache-2.0

The Requires

 

The Development Requires

by Daniel Carbone

curl php

13/09 2016

3.0.1

3.0.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

Apache-2.0

The Requires

 

The Development Requires

by Daniel Carbone

curl php

13/09 2016

3.0.0

3.0.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

Apache-2.0

The Requires

 

The Development Requires

by Daniel Carbone

curl php

25/01 2016

2.1.1

2.1.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

Apache-2.0

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

24/01 2016

2.1.0

2.1.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

Apache-2.0

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

16/12 2015

2.0.1

2.0.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

15/12 2015

2.0.0

2.0.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

30/01 2015

1.0.2

1.0.2.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

30/01 2015

1.0.1

1.0.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

28/10 2014

1.0.0

1.0.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

07/10 2014

0.6.1

0.6.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

15/09 2014

0.6.0

0.6.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

01/09 2014

0.5.1

0.5.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *

 

The Development Requires

by Daniel Carbone

curl php

01/09 2014

0.5.0

0.5.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

The Development Requires

by Daniel Carbone

curl php

25/06 2014

0.4.4

0.4.4.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

25/06 2014

0.4.3

0.4.3.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

25/06 2014

0.4.2

0.4.2.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

23/06 2014

0.4.1

0.4.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

22/06 2014

0.4.0

0.4.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

09/06 2014

0.3.3

0.3.3.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

29/04 2014

0.3.2

0.3.2.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

29/04 2014

0.3.1

0.3.1.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

21/04 2014

0.3.0

0.3.0.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

18/04 2014

0.2.4

0.2.4.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

21/02 2014

0.2.3

0.2.3.0 https://github.com/dcarbone/curl-plus

Object wrapper for PHP's CURL Library

  Sources   Download

MIT

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *

 

by Daniel Carbone

curl php

04/02 2014

0.2.1

0.2.1.0

OO CURL for PHP

  Sources   Download

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *
  • lib-libxml *

 

by Daniel Carbone

04/02 2014

0.2.2

0.2.2.0

OO CURL for PHP

  Sources   Download

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *
  • lib-libxml *

 

by Daniel Carbone

04/02 2014

0.2.0

0.2.0.0

OO CURL for PHP

  Sources   Download

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *
  • lib-libxml *

 

by Daniel Carbone

27/01 2014

0.1.0

0.1.0.0

OO CURL for PHP

  Sources   Download

The Requires

  • php >=5.3.3
  • lib-curl *
  • lib-openssl *
  • lib-libxml *

 

by Daniel Carbone