4 use GuzzleHttp\Handler\CurlHandler;
5 use GuzzleHttp\Handler\CurlMultiHandler;
6 use GuzzleHttp\Handler\Proxy;
7 use GuzzleHttp\Handler\StreamHandler;
10 * Expands a URI template
12 * @param string $template URI template
13 * @param array $variables Template variables
17 function uri_template($template, array $variables)
19 if (extension_loaded('uri_template')) {
20 // @codeCoverageIgnoreStart
21 return \uri_template($template, $variables);
22 // @codeCoverageIgnoreEnd
27 $uriTemplate = new UriTemplate();
30 return $uriTemplate->expand($template, $variables);
34 * Debug function used to describe the provided value type and class.
38 * @return string Returns a string containing the type of the variable and
39 * if a class is provided, the class name.
41 function describe_type($input)
43 switch (gettype($input)) {
45 return 'object(' . get_class($input) . ')';
47 return 'array(' . count($input) . ')';
51 // normalize float vs double
52 return str_replace('double(', 'float(', rtrim(ob_get_clean()));
57 * Parses an array of header lines into an associative array of headers.
59 * @param array $lines Header lines array of strings in the following
60 * format: "Name: Value"
63 function headers_from_lines($lines)
67 foreach ($lines as $line) {
68 $parts = explode(':', $line, 2);
69 $headers[trim($parts[0])][] = isset($parts[1])
78 * Returns a debug stream based on the provided variable.
80 * @param mixed $value Optional value
84 function debug_resource($value = null)
86 if (is_resource($value)) {
88 } elseif (defined('STDOUT')) {
92 return fopen('php://output', 'w');
96 * Chooses and creates a default handler to use based on the environment.
98 * The returned handler is not wrapped by any default middlewares.
100 * @throws \RuntimeException if no viable Handler is available.
101 * @return callable Returns the best handler for the given system.
103 function choose_handler()
106 if (function_exists('curl_multi_exec') && function_exists('curl_exec')) {
107 $handler = Proxy::wrapSync(new CurlMultiHandler(), new CurlHandler());
108 } elseif (function_exists('curl_exec')) {
109 $handler = new CurlHandler();
110 } elseif (function_exists('curl_multi_exec')) {
111 $handler = new CurlMultiHandler();
114 if (ini_get('allow_url_fopen')) {
116 ? Proxy::wrapStreaming($handler, new StreamHandler())
117 : new StreamHandler();
118 } elseif (!$handler) {
119 throw new \RuntimeException('GuzzleHttp requires cURL, the '
120 . 'allow_url_fopen ini setting, or a custom HTTP handler.');
127 * Get the default User-Agent string to use with Guzzle
131 function default_user_agent()
133 static $defaultAgent = '';
135 if (!$defaultAgent) {
136 $defaultAgent = 'GuzzleHttp/' . Client::VERSION;
137 if (extension_loaded('curl') && function_exists('curl_version')) {
138 $defaultAgent .= ' curl/' . \curl_version()['version'];
140 $defaultAgent .= ' PHP/' . PHP_VERSION;
143 return $defaultAgent;
147 * Returns the default cacert bundle for the current system.
149 * First, the openssl.cafile and curl.cainfo php.ini settings are checked.
150 * If those settings are not configured, then the common locations for
151 * bundles found on Red Hat, CentOS, Fedora, Ubuntu, Debian, FreeBSD, OS X
152 * and Windows are checked. If any of these file locations are found on
153 * disk, they will be utilized.
155 * Note: the result of this function is cached for subsequent calls.
158 * @throws \RuntimeException if no bundle can be found.
160 function default_ca_bundle()
162 static $cached = null;
164 // Red Hat, CentOS, Fedora (provided by the ca-certificates package)
165 '/etc/pki/tls/certs/ca-bundle.crt',
166 // Ubuntu, Debian (provided by the ca-certificates package)
167 '/etc/ssl/certs/ca-certificates.crt',
168 // FreeBSD (provided by the ca_root_nss package)
169 '/usr/local/share/certs/ca-root-nss.crt',
170 // SLES 12 (provided by the ca-certificates package)
171 '/var/lib/ca-certificates/ca-bundle.pem',
172 // OS X provided by homebrew (using the default path)
173 '/usr/local/etc/openssl/cert.pem',
175 '/etc/ca-certificates.crt',
177 'C:\\windows\\system32\\curl-ca-bundle.crt',
178 'C:\\windows\\curl-ca-bundle.crt',
185 if ($ca = ini_get('openssl.cafile')) {
186 return $cached = $ca;
189 if ($ca = ini_get('curl.cainfo')) {
190 return $cached = $ca;
193 foreach ($cafiles as $filename) {
194 if (file_exists($filename)) {
195 return $cached = $filename;
199 throw new \RuntimeException(<<< EOT
200 No system CA bundle could be found in any of the the common system locations.
201 PHP versions earlier than 5.6 are not properly configured to use the system's
202 CA bundle by default. In order to verify peer certificates, you will need to
203 supply the path on disk to a certificate bundle to the 'verify' request
204 option: http://docs.guzzlephp.org/en/latest/clients.html#verify. If you do not
205 need a specific certificate bundle, then Mozilla provides a commonly used CA
206 bundle which can be downloaded here (provided by the maintainer of cURL):
207 https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt. Once
208 you have a CA bundle available on disk, you can set the 'openssl.cafile' PHP
209 ini setting to point to the path to the file, allowing you to omit the 'verify'
210 request option. See http://curl.haxx.se/docs/sslcerts.html for more
217 * Creates an associative array of lowercase header names to the actual
220 * @param array $headers
224 function normalize_header_keys(array $headers)
227 foreach (array_keys($headers) as $key) {
228 $result[strtolower($key)] = $key;
235 * Returns true if the provided host matches any of the no proxy areas.
237 * This method will strip a port from the host if it is present. Each pattern
238 * can be matched with an exact match (e.g., "foo.com" == "foo.com") or a
239 * partial match: (e.g., "foo.com" == "baz.foo.com" and ".foo.com" ==
240 * "baz.foo.com", but ".foo.com" != "foo.com").
242 * Areas are matched in the following cases:
243 * 1. "*" (without quotes) always matches any hosts.
245 * 3. The area starts with "." and the area is the last part of the host. e.g.
246 * '.mit.edu' will match any host that ends with '.mit.edu'.
248 * @param string $host Host to check against the patterns.
249 * @param array $noProxyArray An array of host patterns.
253 function is_host_in_noproxy($host, array $noProxyArray)
255 if (strlen($host) === 0) {
256 throw new \InvalidArgumentException('Empty host provided');
259 // Strip port if present.
260 if (strpos($host, ':')) {
261 $host = explode($host, ':', 2)[0];
264 foreach ($noProxyArray as $area) {
265 // Always match on wildcards.
268 } elseif (empty($area)) {
269 // Don't match on empty values.
271 } elseif ($area === $host) {
275 // Special match if the area when prefixed with ".". Remove any
276 // existing leading "." and add a new leading ".".
277 $area = '.' . ltrim($area, '.');
278 if (substr($host, -(strlen($area))) === $area) {
288 * Wrapper for json_decode that throws when an error occurs.
290 * @param string $json JSON data to parse
291 * @param bool $assoc When true, returned objects will be converted
292 * into associative arrays.
293 * @param int $depth User specified recursion depth.
294 * @param int $options Bitmask of JSON decode options.
297 * @throws \InvalidArgumentException if the JSON cannot be decoded.
298 * @link http://www.php.net/manual/en/function.json-decode.php
300 function json_decode($json, $assoc = false, $depth = 512, $options = 0)
302 $data = \json_decode($json, $assoc, $depth, $options);
303 if (JSON_ERROR_NONE !== json_last_error()) {
304 throw new \InvalidArgumentException(
305 'json_decode error: ' . json_last_error_msg());
312 * Wrapper for JSON encoding that throws when an error occurs.
314 * @param mixed $value The value being encoded
315 * @param int $options JSON encode option bitmask
316 * @param int $depth Set the maximum depth. Must be greater than zero.
319 * @throws \InvalidArgumentException if the JSON cannot be encoded.
320 * @link http://www.php.net/manual/en/function.json-encode.php
322 function json_encode($value, $options = 0, $depth = 512)
324 $json = \json_encode($value, $options, $depth);
325 if (JSON_ERROR_NONE !== json_last_error()) {
326 throw new \InvalidArgumentException(
327 'json_encode error: ' . json_last_error_msg());