v1.4.2
This commit is contained in:
parent
6a8de6e2e2
commit
a80a4aa4f9
1 changed files with 3186001 additions and 9155 deletions
159
vendor/guzzlehttp/guzzle/src/Handler/ProxyEnv.php
vendored
Normal file
159
vendor/guzzlehttp/guzzle/src/Handler/ProxyEnv.php
vendored
Normal file
|
|
@ -0,0 +1,159 @@
|
|||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace GuzzleHttp\Handler;
|
||||
|
||||
use GuzzleHttp\ProxyOptions;
|
||||
use GuzzleHttp\ProxySelection;
|
||||
use GuzzleHttp\Psr7;
|
||||
use Psr\Http\Message\UriInterface;
|
||||
|
||||
/**
|
||||
* Resolves proxy configuration from the process environment with the same
|
||||
* semantics libcurl applies, shared by the built-in handlers: the cURL
|
||||
* handlers pin CURLOPT_PROXY and CURLOPT_NOPROXY explicitly so libcurl never
|
||||
* reads the environment itself, and the stream handler resolves the same way.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
final class ProxyEnv
|
||||
{
|
||||
private function __construct()
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
* Resolves the proxy selection for a request, falling back to the proxy
|
||||
* environment variables when the proxy request option makes no decision.
|
||||
*
|
||||
* The environment no_proxy list is tokenized the way libcurl tokenizes
|
||||
* it and matched here with the same rules as the proxy option's "no"
|
||||
* list, so behavior does not depend on the installed libcurl's matcher.
|
||||
*
|
||||
* @param mixed $proxyOption
|
||||
*/
|
||||
public static function resolveProxySelection(
|
||||
UriInterface $uri,
|
||||
#[\SensitiveParameter]
|
||||
$proxyOption
|
||||
): ProxySelection {
|
||||
$selection = ProxyOptions::resolve($uri, $proxyOption);
|
||||
|
||||
// Any option decision (proxy, bypassed, or disabled) is final; only
|
||||
// a none() selection leaves room for the environment.
|
||||
if ($selection->hasProxy() || $selection->shouldDisableProxy()) {
|
||||
return $selection;
|
||||
}
|
||||
|
||||
$envProxy = self::getProxyForScheme($uri->getScheme());
|
||||
if ($envProxy === null) {
|
||||
return $selection;
|
||||
}
|
||||
|
||||
$noProxy = self::getNoProxy();
|
||||
if ($noProxy !== null && ProxyOptions::isUriInNoProxy($uri, self::splitNoProxy($noProxy))) {
|
||||
return ProxySelection::bypassed();
|
||||
}
|
||||
|
||||
// $envProxy is never '' (empty env values are treated as unset).
|
||||
return ProxySelection::proxy($envProxy);
|
||||
}
|
||||
|
||||
/**
|
||||
* Resolves the proxy to use for the given request scheme.
|
||||
*
|
||||
* The lookup mirrors libcurl for the http and https schemes the handlers
|
||||
* accept: the lowercase scheme-specific variable first, its uppercase
|
||||
* variant next (except for "http", where uppercase HTTP_PROXY is never
|
||||
* read), then all_proxy/ALL_PROXY.
|
||||
*
|
||||
* @return string|null The proxy to use; null when the environment
|
||||
* configures none.
|
||||
*/
|
||||
public static function getProxyForScheme(string $scheme): ?string
|
||||
{
|
||||
$scheme = Psr7\Utils::asciiToLower($scheme);
|
||||
$candidates = [$scheme.'_proxy'];
|
||||
if ($scheme !== 'http') {
|
||||
// Uppercase HTTP_PROXY is deliberately never consulted: a CGI
|
||||
// request header "Proxy:" becomes HTTP_PROXY in the environment.
|
||||
// See https://httpoxy.org for more information.
|
||||
$candidates[] = Psr7\Utils::asciiToUpper($scheme).'_PROXY';
|
||||
}
|
||||
$candidates[] = 'all_proxy';
|
||||
$candidates[] = 'ALL_PROXY';
|
||||
|
||||
foreach ($candidates as $name) {
|
||||
$value = self::getenv($name);
|
||||
if ($value !== null) {
|
||||
return $value;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string|null The no-proxy list; null when nothing is set.
|
||||
*/
|
||||
public static function getNoProxy(): ?string
|
||||
{
|
||||
foreach (['no_proxy', 'NO_PROXY'] as $name) {
|
||||
$value = self::getenv($name);
|
||||
if ($value !== null) {
|
||||
return $value;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Splits a no_proxy environment value into matchable entries.
|
||||
*
|
||||
* Entries may be separated by commas or blanks, the way libcurl tokenizes
|
||||
* the value.
|
||||
*
|
||||
* @return string[]
|
||||
*/
|
||||
public static function splitNoProxy(string $noProxy): array
|
||||
{
|
||||
$entries = [];
|
||||
|
||||
$split = \preg_split('/[\s,]+/', $noProxy);
|
||||
|
||||
if ($split === false) {
|
||||
throw new \RuntimeException('Unable to split the no_proxy value: '.\preg_last_error_msg());
|
||||
}
|
||||
|
||||
foreach ($split as $entry) {
|
||||
if ($entry !== '') {
|
||||
$entries[] = $entry;
|
||||
}
|
||||
}
|
||||
|
||||
return $entries;
|
||||
}
|
||||
|
||||
private static function getenv(string $name): ?string
|
||||
{
|
||||
// Windows environment variables are case-insensitive, so the
|
||||
// lowercase-only httpoxy defence does not hold there. Outside the
|
||||
// CLI SAPI on Windows, environment proxies are not resolved at all
|
||||
// (a safe-side divergence from libcurl).
|
||||
if (\PHP_OS_FAMILY === 'Windows' && \PHP_SAPI !== 'cli') {
|
||||
return null;
|
||||
}
|
||||
|
||||
// local_only: the OS environment and putenv() only - the same
|
||||
// environ(7) libcurl reads. SAPI request environments such as
|
||||
// fastcgi_param or SetEnv are deliberately excluded.
|
||||
$value = \getenv($name, true);
|
||||
|
||||
// libcurl's GetEnv (lib/getenv.c) treats variables set to an empty
|
||||
// string as unset on every version, so the lookup falls through to
|
||||
// the next candidate.
|
||||
return $value === false || $value === '' ? null : $value;
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue