| 1 |
<?php |
| 2 |
|
| 3 |
namespace YoastSEO_Vendor\GuzzleHttp\Handler; |
| 4 |
|
| 5 |
/** |
| 6 |
* Resolves proxy configuration from the process environment with the same |
| 7 |
* semantics libcurl applies, so the cURL handlers can pin CURLOPT_PROXY and |
| 8 |
* CURLOPT_NOPROXY explicitly and libcurl never reads the environment itself. |
| 9 |
* |
| 10 |
* @internal |
| 11 |
*/ |
| 12 |
final class ProxyEnvironment |
| 13 |
{ |
| 14 |
private function __construct() |
| 15 |
{ |
| 16 |
} |
| 17 |
/** |
| 18 |
* Resolves the proxy to use for the given request scheme. |
| 19 |
* |
| 20 |
* The lookup mirrors libcurl for the http and https schemes the handlers |
| 21 |
* accept: the lowercase scheme-specific variable first, its uppercase |
| 22 |
* variant next (except for "http", where uppercase HTTP_PROXY is never |
| 23 |
* read), then all_proxy/ALL_PROXY. |
| 24 |
* |
| 25 |
* @return string|null The proxy to use; null when the environment |
| 26 |
* configures none. |
| 27 |
*/ |
| 28 |
public static function getProxyForScheme(string $scheme) : ?string |
| 29 |
{ |
| 30 |
$scheme = \strtolower($scheme); |
| 31 |
$candidates = [$scheme . '_proxy']; |
| 32 |
if ($scheme !== 'http') { |
| 33 |
// Uppercase HTTP_PROXY is deliberately never consulted: a CGI |
| 34 |
// request header "Proxy:" becomes HTTP_PROXY in the environment. |
| 35 |
// See https://httpoxy.org for more information. |
| 36 |
$candidates[] = \strtoupper($scheme) . '_PROXY'; |
| 37 |
} |
| 38 |
$candidates[] = 'all_proxy'; |
| 39 |
$candidates[] = 'ALL_PROXY'; |
| 40 |
foreach ($candidates as $name) { |
| 41 |
$value = self::getenv($name); |
| 42 |
if ($value !== null) { |
| 43 |
return $value; |
| 44 |
} |
| 45 |
} |
| 46 |
return null; |
| 47 |
} |
| 48 |
/** |
| 49 |
* @return string|null The no-proxy list; null when nothing is set. |
| 50 |
*/ |
| 51 |
public static function getNoProxy() : ?string |
| 52 |
{ |
| 53 |
foreach (['no_proxy', 'NO_PROXY'] as $name) { |
| 54 |
$value = self::getenv($name); |
| 55 |
if ($value !== null) { |
| 56 |
return $value; |
| 57 |
} |
| 58 |
} |
| 59 |
return null; |
| 60 |
} |
| 61 |
/** |
| 62 |
* Splits a no_proxy environment value into matchable entries. |
| 63 |
* |
| 64 |
* Mirrors libcurl's tokenization: entries may be separated by commas or |
| 65 |
* blanks, and a single leading dot is ignored, so ".example.com" bypasses |
| 66 |
* example.com and its subdomains exactly as a bare domain entry does. |
| 67 |
* |
| 68 |
* @return string[] |
| 69 |
*/ |
| 70 |
public static function splitNoProxy(string $noProxy) : array |
| 71 |
{ |
| 72 |
$entries = []; |
| 73 |
foreach (\preg_split('/[\\s,]+/', $noProxy) ?: [] as $entry) { |
| 74 |
if ($entry !== '' && $entry[0] === '.') { |
| 75 |
$entry = \substr($entry, 1); |
| 76 |
} |
| 77 |
if ($entry !== '') { |
| 78 |
$entries[] = $entry; |
| 79 |
} |
| 80 |
} |
| 81 |
return $entries; |
| 82 |
} |
| 83 |
private static function getenv(string $name) : ?string |
| 84 |
{ |
| 85 |
// Windows environment variables are case-insensitive, so the |
| 86 |
// lowercase-only httpoxy defence does not hold there. Outside the |
| 87 |
// CLI SAPI on Windows, environment proxies are not resolved at all |
| 88 |
// (a safe-side divergence from libcurl). |
| 89 |
if (\PHP_OS_FAMILY === 'Windows' && \PHP_SAPI !== 'cli') { |
| 90 |
return null; |
| 91 |
} |
| 92 |
// local_only: the OS environment and putenv() only - the same |
| 93 |
// environ(7) libcurl reads. SAPI request environments such as |
| 94 |
// fastcgi_param or SetEnv are deliberately excluded. |
| 95 |
$value = \getenv($name, \true); |
| 96 |
// libcurl's GetEnv (lib/getenv.c) treats variables set to an empty |
| 97 |
// string as unset on every version, so the lookup falls through to |
| 98 |
// the next candidate. |
| 99 |
return $value === \false || $value === '' ? null : $value; |
| 100 |
} |
| 101 |
} |
| 102 |
|
