UrlRsrc

 UrlRsrc - fetch an URL (file) resource content

• urlRsrc is a Curl wrapper and implements a (no-cache) http GET request.
   
• Output is a URL resource content string.
   
• Throws InvalidArgumentException/RuntimeException on error (also http code >= 400).
   
• No cookie or return headers managent, works out-of-the-box.

USAGE

<?php
namespace Kigkonsult\Http;

include __DIR__ . '/vendor/autoload.php';

/**
 * @param string $url            the url (file) resource
 *                               for missning scheme 'http' is used
 * @param array  $urlArgs        opt, *( urlArgKey => value )
 *                               if not empty, appended to url
 * @param array  $curlOpts       opt, *( curlOptConstant => value )
 *                               overwrites default (below) key value
 *                               if key exists
 *                               The keys should be valid curl_setopt()
 *                               constants  or their integer equivalents.
 * @param int    $sizeDownload   hold (byte-)size of downloaded resource
 * @param float  $time           hold operation exec time (in seconds)
 * @return string
 * @throws InvalidArgumentException
 * @throws RuntimeException
 */

$content = UrlRsrc::getContent( 'example.com' );

Curl options

Default Curl options are

CURLOPT_FAILONERROR => true,

fail if HTTP return code >= 400

CURLOPT_FOLLOWLOCATION => true,

follow redirects

CURLOPT_FRESH_CONNECT => true,

use a NO-cached connection

CURLOPT_USERAGENT => 'cURL',

content of the "User-Agent: " header

CURLOPT_HTTPHEADER => [ 'Accept: */*' ],

array of HTTP headers, default Accept everything

example : prefer html/xml but...

'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8'

CURLOPT_RETURNTRANSFER => true,

get URL contents

CURLOPT_CONNECTTIMEOUT => 60,

max seconds to wait before connect timeout

CURLOPT_TIMEOUT => 60,

max seconds to wait before cUrl execute timeout

CURLOPT_SSL_VERIFYHOST => 0,

no check of common the names in the SSL peer certificate

Note

CURLOPT_SSL_VERIFYPEER is (auto-)set depending on URL scheme; https gives true else false

UrlRsrc is indended to work without other added Curl options but
some URLs may require some

Opt certificate directives :

CURLOPT_CAINFO => __DIR__ . '/cacert.pem'

certificate file

download up-to-date from http://curl.haxx.se/docs/caextract.html

CURLOPT_CAPATH => 'fullPath/to/certs/dir'

certificates directory

How to implement (opt) basic authentication :

CURLOPT_HTTPAUTH => CURLAUTH_BASIC

CURLOPT_USERPWD => sprintf( '%s:%s', $userName, $password )

CurlOpts argument array key value overwrites default (above) if key is set.

More info about Curl options at php.net.