/home/mip/www/img/credit/datatables/Middleware.php.tar
home/mip/mip/vendor/aws/aws-sdk-php/src/Middleware.php 0000644 00000037167 15152066121 0016665 0 ustar 00 <?php
namespace Aws;
use Aws\Api\Service;
use Aws\Api\Validator;
use Aws\Credentials\CredentialsInterface;
use Aws\EndpointV2\EndpointProviderV2;
use Aws\Exception\AwsException;
use Aws\Signature\S3ExpressSignature;
use Aws\Token\TokenAuthorization;
use Aws\Token\TokenInterface;
use GuzzleHttp\Promise;
use GuzzleHttp\Psr7;
use GuzzleHttp\Psr7\LazyOpenStream;
use Psr\Http\Message\RequestInterface;
final class Middleware
{
/**
* Middleware used to allow a command parameter (e.g., "SourceFile") to
* be used to specify the source of data for an upload operation.
*
* @param Service $api
* @param string $bodyParameter
* @param string $sourceParameter
*
* @return callable
*/
public static function sourceFile(
Service $api,
$bodyParameter = 'Body',
$sourceParameter = 'SourceFile'
) {
return function (callable $handler) use (
$api,
$bodyParameter,
$sourceParameter
) {
return function (
CommandInterface $command,
RequestInterface $request = null)
use (
$handler,
$api,
$bodyParameter,
$sourceParameter
) {
$operation = $api->getOperation($command->getName());
$source = $command[$sourceParameter];
if ($source !== null
&& $operation->getInput()->hasMember($bodyParameter)
) {
$command[$bodyParameter] = new LazyOpenStream($source, 'r');
unset($command[$sourceParameter]);
}
return $handler($command, $request);
};
};
}
/**
* Adds a middleware that uses client-side validation.
*
* @param Service $api API being accessed.
*
* @return callable
*/
public static function validation(Service $api, Validator $validator = null)
{
$validator = $validator ?: new Validator();
return function (callable $handler) use ($api, $validator) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($api, $validator, $handler) {
if ($api->isModifiedModel()) {
$api = new Service(
$api->getDefinition(),
$api->getProvider()
);
}
$operation = $api->getOperation($command->getName());
$validator->validate(
$command->getName(),
$operation->getInput(),
$command->toArray()
);
return $handler($command, $request);
};
};
}
/**
* Builds an HTTP request for a command.
*
* @param callable $serializer Function used to serialize a request for a
* command.
* @param EndpointProviderV2 | null $endpointProvider
* @param array $providerArgs
* @return callable
*/
public static function requestBuilder($serializer)
{
return function (callable $handler) use ($serializer) {
return function (CommandInterface $command, $endpoint = null) use ($serializer, $handler) {
return $handler($command, $serializer($command, $endpoint));
};
};
}
/**
* Creates a middleware that signs requests for a command.
*
* @param callable $credProvider Credentials provider function that
* returns a promise that is resolved
* with a CredentialsInterface object.
* @param callable $signatureFunction Function that accepts a Command
* object and returns a
* SignatureInterface.
*
* @return callable
*/
public static function signer(callable $credProvider, callable $signatureFunction, $tokenProvider = null, $config = [])
{
return function (callable $handler) use ($signatureFunction, $credProvider, $tokenProvider, $config) {
return function (
CommandInterface $command,
RequestInterface $request
) use ($handler, $signatureFunction, $credProvider, $tokenProvider, $config) {
$signer = $signatureFunction($command);
if ($signer instanceof TokenAuthorization) {
return $tokenProvider()->then(
function (TokenInterface $token)
use ($handler, $command, $signer, $request) {
return $handler(
$command,
$signer->authorizeRequest($request, $token)
);
}
);
}
if ($signer instanceof S3ExpressSignature) {
$credentialPromise = $config['s3_express_identity_provider']($command);
} else {
$credentialPromise = $credProvider();
}
return $credentialPromise->then(
function (CredentialsInterface $creds)
use ($handler, $command, $signer, $request) {
return $handler(
$command,
$signer->signRequest($request, $creds)
);
}
);
};
};
}
/**
* Creates a middleware that invokes a callback at a given step.
*
* The tap callback accepts a CommandInterface and RequestInterface as
* arguments but is not expected to return a new value or proxy to
* downstream middleware. It's simply a way to "tap" into the handler chain
* to debug or get an intermediate value.
*
* @param callable $fn Tap function
*
* @return callable
*/
public static function tap(callable $fn)
{
return function (callable $handler) use ($fn) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $fn) {
$fn($command, $request);
return $handler($command, $request);
};
};
}
/**
* Middleware wrapper function that retries requests based on the boolean
* result of invoking the provided "decider" function.
*
* If no delay function is provided, a simple implementation of exponential
* backoff will be utilized.
*
* @param callable $decider Function that accepts the number of retries,
* a request, [result], and [exception] and
* returns true if the command is to be retried.
* @param callable $delay Function that accepts the number of retries and
* returns the number of milliseconds to delay.
* @param bool $stats Whether to collect statistics on retries and the
* associated delay.
*
* @return callable
*/
public static function retry(
callable $decider = null,
callable $delay = null,
$stats = false
) {
$decider = $decider ?: RetryMiddleware::createDefaultDecider();
$delay = $delay ?: [RetryMiddleware::class, 'exponentialDelay'];
return function (callable $handler) use ($decider, $delay, $stats) {
return new RetryMiddleware($decider, $delay, $handler, $stats);
};
}
/**
* Middleware wrapper function that adds an invocation id header to
* requests, which is only applied after the build step.
*
* This is a uniquely generated UUID to identify initial and subsequent
* retries as part of a complete request lifecycle.
*
* @return callable
*/
public static function invocationId()
{
return function (callable $handler) {
return function (
CommandInterface $command,
RequestInterface $request
) use ($handler){
return $handler($command, $request->withHeader(
'aws-sdk-invocation-id',
md5(uniqid(gethostname(), true))
));
};
};
}
/**
* Middleware wrapper function that adds a Content-Type header to requests.
* This is only done when the Content-Type has not already been set, and the
* request body's URI is available. It then checks the file extension of the
* URI to determine the mime-type.
*
* @param array $operations Operations that Content-Type should be added to.
*
* @return callable
*/
public static function contentType(array $operations)
{
return function (callable $handler) use ($operations) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $operations) {
if (!$request->hasHeader('Content-Type')
&& in_array($command->getName(), $operations, true)
&& ($uri = $request->getBody()->getMetadata('uri'))
) {
$request = $request->withHeader(
'Content-Type',
Psr7\MimeType::fromFilename($uri) ?: 'application/octet-stream'
);
}
return $handler($command, $request);
};
};
}
/**
* Middleware wrapper function that adds a trace id header to requests
* from clients instantiated in supported Lambda runtime environments.
*
* The purpose for this header is to track and stop Lambda functions
* from being recursively invoked due to misconfigured resources.
*
* @return callable
*/
public static function recursionDetection()
{
return function (callable $handler) {
return function (
CommandInterface $command,
RequestInterface $request
) use ($handler){
$isLambda = getenv('AWS_LAMBDA_FUNCTION_NAME');
$traceId = str_replace('\e', '\x1b', getenv('_X_AMZN_TRACE_ID'));
if ($isLambda && $traceId) {
if (!$request->hasHeader('X-Amzn-Trace-Id')) {
$ignoreChars = ['=', ';', ':', '+', '&', '[', ']', '{', '}', '"', '\'', ','];
$traceIdEncoded = rawurlencode(stripcslashes($traceId));
foreach($ignoreChars as $char) {
$encodedChar = rawurlencode($char);
$traceIdEncoded = str_replace($encodedChar, $char, $traceIdEncoded);
}
return $handler($command, $request->withHeader(
'X-Amzn-Trace-Id',
$traceIdEncoded
));
}
}
return $handler($command, $request);
};
};
}
/**
* Tracks command and request history using a history container.
*
* This is useful for testing.
*
* @param History $history History container to store entries.
*
* @return callable
*/
public static function history(History $history)
{
return function (callable $handler) use ($history) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $history) {
$ticket = $history->start($command, $request);
return $handler($command, $request)
->then(
function ($result) use ($history, $ticket) {
$history->finish($ticket, $result);
return $result;
},
function ($reason) use ($history, $ticket) {
$history->finish($ticket, $reason);
return Promise\Create::rejectionFor($reason);
}
);
};
};
}
/**
* Creates a middleware that applies a map function to requests as they
* pass through the middleware.
*
* @param callable $f Map function that accepts a RequestInterface and
* returns a RequestInterface.
*
* @return callable
*/
public static function mapRequest(callable $f)
{
return function (callable $handler) use ($f) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $f) {
return $handler($command, $f($request));
};
};
}
/**
* Creates a middleware that applies a map function to commands as they
* pass through the middleware.
*
* @param callable $f Map function that accepts a command and returns a
* command.
*
* @return callable
*/
public static function mapCommand(callable $f)
{
return function (callable $handler) use ($f) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $f) {
return $handler($f($command), $request);
};
};
}
/**
* Creates a middleware that applies a map function to results.
*
* @param callable $f Map function that accepts an Aws\ResultInterface and
* returns an Aws\ResultInterface.
*
* @return callable
*/
public static function mapResult(callable $f)
{
return function (callable $handler) use ($f) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler, $f) {
return $handler($command, $request)->then($f);
};
};
}
public static function timer()
{
return function (callable $handler) {
return function (
CommandInterface $command,
RequestInterface $request = null
) use ($handler) {
$start = microtime(true);
return $handler($command, $request)
->then(
function (ResultInterface $res) use ($start) {
if (!isset($res['@metadata'])) {
$res['@metadata'] = [];
}
if (!isset($res['@metadata']['transferStats'])) {
$res['@metadata']['transferStats'] = [];
}
$res['@metadata']['transferStats']['total_time']
= microtime(true) - $start;
return $res;
},
function ($err) use ($start) {
if ($err instanceof AwsException) {
$err->setTransferInfo([
'total_time' => microtime(true) - $start,
] + $err->getTransferInfo());
}
return Promise\Create::rejectionFor($err);
}
);
};
};
}
}
home/mip/mip/vendor/guzzlehttp/guzzle/src/Middleware.php 0000644 00000025626 15152066546 0017505 0 ustar 00 <?php
namespace GuzzleHttp;
use GuzzleHttp\Cookie\CookieJarInterface;
use GuzzleHttp\Exception\RequestException;
use GuzzleHttp\Promise as P;
use GuzzleHttp\Promise\PromiseInterface;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Log\LoggerInterface;
/**
* Functions used to create and wrap handlers with handler middleware.
*/
final class Middleware
{
/**
* Middleware that adds cookies to requests.
*
* The options array must be set to a CookieJarInterface in order to use
* cookies. This is typically handled for you by a client.
*
* @return callable Returns a function that accepts the next handler.
*/
public static function cookies(): callable
{
return static function (callable $handler): callable {
return static function ($request, array $options) use ($handler) {
if (empty($options['cookies'])) {
return $handler($request, $options);
} elseif (!($options['cookies'] instanceof CookieJarInterface)) {
throw new \InvalidArgumentException('cookies must be an instance of GuzzleHttp\Cookie\CookieJarInterface');
}
$cookieJar = $options['cookies'];
$request = $cookieJar->withCookieHeader($request);
return $handler($request, $options)
->then(
static function (ResponseInterface $response) use ($cookieJar, $request): ResponseInterface {
$cookieJar->extractCookies($request, $response);
return $response;
}
);
};
};
}
/**
* Middleware that throws exceptions for 4xx or 5xx responses when the
* "http_errors" request option is set to true.
*
* @param BodySummarizerInterface|null $bodySummarizer The body summarizer to use in exception messages.
*
* @return callable(callable): callable Returns a function that accepts the next handler.
*/
public static function httpErrors(BodySummarizerInterface $bodySummarizer = null): callable
{
return static function (callable $handler) use ($bodySummarizer): callable {
return static function ($request, array $options) use ($handler, $bodySummarizer) {
if (empty($options['http_errors'])) {
return $handler($request, $options);
}
return $handler($request, $options)->then(
static function (ResponseInterface $response) use ($request, $bodySummarizer) {
$code = $response->getStatusCode();
if ($code < 400) {
return $response;
}
throw RequestException::create($request, $response, null, [], $bodySummarizer);
}
);
};
};
}
/**
* Middleware that pushes history data to an ArrayAccess container.
*
* @param array|\ArrayAccess<int, array> $container Container to hold the history (by reference).
*
* @return callable(callable): callable Returns a function that accepts the next handler.
*
* @throws \InvalidArgumentException if container is not an array or ArrayAccess.
*/
public static function history(&$container): callable
{
if (!\is_array($container) && !$container instanceof \ArrayAccess) {
throw new \InvalidArgumentException('history container must be an array or object implementing ArrayAccess');
}
return static function (callable $handler) use (&$container): callable {
return static function (RequestInterface $request, array $options) use ($handler, &$container) {
return $handler($request, $options)->then(
static function ($value) use ($request, &$container, $options) {
$container[] = [
'request' => $request,
'response' => $value,
'error' => null,
'options' => $options,
];
return $value;
},
static function ($reason) use ($request, &$container, $options) {
$container[] = [
'request' => $request,
'response' => null,
'error' => $reason,
'options' => $options,
];
return P\Create::rejectionFor($reason);
}
);
};
};
}
/**
* Middleware that invokes a callback before and after sending a request.
*
* The provided listener cannot modify or alter the response. It simply
* "taps" into the chain to be notified before returning the promise. The
* before listener accepts a request and options array, and the after
* listener accepts a request, options array, and response promise.
*
* @param callable $before Function to invoke before forwarding the request.
* @param callable $after Function invoked after forwarding.
*
* @return callable Returns a function that accepts the next handler.
*/
public static function tap(callable $before = null, callable $after = null): callable
{
return static function (callable $handler) use ($before, $after): callable {
return static function (RequestInterface $request, array $options) use ($handler, $before, $after) {
if ($before) {
$before($request, $options);
}
$response = $handler($request, $options);
if ($after) {
$after($request, $options, $response);
}
return $response;
};
};
}
/**
* Middleware that handles request redirects.
*
* @return callable Returns a function that accepts the next handler.
*/
public static function redirect(): callable
{
return static function (callable $handler): RedirectMiddleware {
return new RedirectMiddleware($handler);
};
}
/**
* Middleware that retries requests based on the boolean result of
* invoking the provided "decider" function.
*
* If no delay function is provided, a simple implementation of exponential
* backoff will be utilized.
*
* @param callable $decider Function that accepts the number of retries,
* a request, [response], and [exception] and
* returns true if the request is to be retried.
* @param callable $delay Function that accepts the number of retries and
* returns the number of milliseconds to delay.
*
* @return callable Returns a function that accepts the next handler.
*/
public static function retry(callable $decider, callable $delay = null): callable
{
return static function (callable $handler) use ($decider, $delay): RetryMiddleware {
return new RetryMiddleware($decider, $handler, $delay);
};
}
/**
* Middleware that logs requests, responses, and errors using a message
* formatter.
*
* @phpstan-param \Psr\Log\LogLevel::* $logLevel Level at which to log requests.
*
* @param LoggerInterface $logger Logs messages.
* @param MessageFormatterInterface|MessageFormatter $formatter Formatter used to create message strings.
* @param string $logLevel Level at which to log requests.
*
* @return callable Returns a function that accepts the next handler.
*/
public static function log(LoggerInterface $logger, $formatter, string $logLevel = 'info'): callable
{
// To be compatible with Guzzle 7.1.x we need to allow users to pass a MessageFormatter
if (!$formatter instanceof MessageFormatter && !$formatter instanceof MessageFormatterInterface) {
throw new \LogicException(sprintf('Argument 2 to %s::log() must be of type %s', self::class, MessageFormatterInterface::class));
}
return static function (callable $handler) use ($logger, $formatter, $logLevel): callable {
return static function (RequestInterface $request, array $options = []) use ($handler, $logger, $formatter, $logLevel) {
return $handler($request, $options)->then(
static function ($response) use ($logger, $request, $formatter, $logLevel): ResponseInterface {
$message = $formatter->format($request, $response);
$logger->log($logLevel, $message);
return $response;
},
static function ($reason) use ($logger, $request, $formatter): PromiseInterface {
$response = $reason instanceof RequestException ? $reason->getResponse() : null;
$message = $formatter->format($request, $response, P\Create::exceptionFor($reason));
$logger->error($message);
return P\Create::rejectionFor($reason);
}
);
};
};
}
/**
* This middleware adds a default content-type if possible, a default
* content-length or transfer-encoding header, and the expect header.
*/
public static function prepareBody(): callable
{
return static function (callable $handler): PrepareBodyMiddleware {
return new PrepareBodyMiddleware($handler);
};
}
/**
* Middleware that applies a map function to the request before passing to
* the next handler.
*
* @param callable $fn Function that accepts a RequestInterface and returns
* a RequestInterface.
*/
public static function mapRequest(callable $fn): callable
{
return static function (callable $handler) use ($fn): callable {
return static function (RequestInterface $request, array $options) use ($handler, $fn) {
return $handler($fn($request), $options);
};
};
}
/**
* Middleware that applies a map function to the resolved promise's
* response.
*
* @param callable $fn Function that accepts a ResponseInterface and
* returns a ResponseInterface.
*/
public static function mapResponse(callable $fn): callable
{
return static function (callable $handler) use ($fn): callable {
return static function (RequestInterface $request, array $options) use ($handler, $fn) {
return $handler($request, $options)->then($fn);
};
};
}
}
