: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
namespace YoastSEO_Vendor\GuzzleHttp;
use YoastSEO_Vendor\GuzzleHttp\Promise\PromiseInterface;
use YoastSEO_Vendor\Psr\Http\Message\RequestInterface;
use YoastSEO_Vendor\Psr\Http\Message\ResponseInterface;
* Creates a composed Guzzle handler function by stacking middlewares on top of
* an HTTP handler function.
* @var (callable(RequestInterface, array): PromiseInterface)|null
* @var array{(callable(callable(RequestInterface, array): PromiseInterface): callable), (string|null)}[]
* @var (callable(RequestInterface, array): PromiseInterface)|null
* Creates a default handler stack that can be used by clients.
* The returned handler will wrap the provided handler or use the most
* appropriate default handler for your system. The returned HandlerStack has
* support for cookies, redirects, HTTP error exceptions, and preparing a body
* The returned handler stack can be passed to a client in the "handler"
* @param (callable(RequestInterface, array): PromiseInterface)|null $handler HTTP handler function to use with the stack. If no
* handler is provided, the best handler for your
* system will be utilized.
public static function create(callable $handler = null) : self
$stack = new self($handler ?: \YoastSEO_Vendor\GuzzleHttp\Utils::chooseHandler());
$stack->push(\YoastSEO_Vendor\GuzzleHttp\Middleware::httpErrors(), 'http_errors');
$stack->push(\YoastSEO_Vendor\GuzzleHttp\Middleware::redirect(), 'allow_redirects');
$stack->push(\YoastSEO_Vendor\GuzzleHttp\Middleware::cookies(), 'cookies');
$stack->push(\YoastSEO_Vendor\GuzzleHttp\Middleware::prepareBody(), 'prepare_body');
* @param (callable(RequestInterface, array): PromiseInterface)|null $handler Underlying HTTP handler.
public function __construct(callable $handler = null)
$this->handler = $handler;
* Invokes the handler stack as a composed handler
* @return ResponseInterface|PromiseInterface
public function __invoke(\YoastSEO_Vendor\Psr\Http\Message\RequestInterface $request, array $options)
$handler = $this->resolve();
return $handler($request, $options);
* Dumps a string representation of the stack.
public function __toString()
if ($this->handler !== null) {
$stack[] = '0) Handler: ' . $this->debugCallable($this->handler);
foreach (\array_reverse($this->stack) as $tuple) {
$str = "{$depth}) Name: '{$tuple[1]}', ";
$str .= 'Function: ' . $this->debugCallable($tuple[0]);
$result = "> {$str}\n{$result}";
foreach (\array_keys($stack) as $k) {
$result .= "< {$stack[$k]}\n";
* Set the HTTP handler that actually returns a promise.
* @param callable(RequestInterface, array): PromiseInterface $handler Accepts a request and array of options and
public function setHandler(callable $handler) : void
$this->handler = $handler;
* Returns true if the builder has a handler.
public function hasHandler() : bool
return $this->handler !== null;
* Unshift a middleware to the bottom of the stack.
* @param callable(callable): callable $middleware Middleware function
* @param string $name Name to register for this middleware.
public function unshift(callable $middleware, string $name = null) : void
\array_unshift($this->stack, [$middleware, $name]);
* Push a middleware to the top of the stack.
* @param callable(callable): callable $middleware Middleware function
* @param string $name Name to register for this middleware.
public function push(callable $middleware, string $name = '') : void
$this->stack[] = [$middleware, $name];
* Add a middleware before another middleware by name.
* @param string $findName Middleware to find
* @param callable(callable): callable $middleware Middleware function
* @param string $withName Name to register for this middleware.
public function before(string $findName, callable $middleware, string $withName = '') : void
$this->splice($findName, $withName, $middleware, \true);
* Add a middleware after another middleware by name.
* @param string $findName Middleware to find
* @param callable(callable): callable $middleware Middleware function
* @param string $withName Name to register for this middleware.
public function after(string $findName, callable $middleware, string $withName = '') : void
$this->splice($findName, $withName, $middleware, \false);
* Remove a middleware by instance or name from the stack.
* @param callable|string $remove Middleware to remove by instance or name.
public function remove($remove) : void
if (!\is_string($remove) && !\is_callable($remove)) {
trigger_deprecation('guzzlehttp/guzzle', '7.4', 'Not passing a callable or string to %s::%s() is deprecated and will cause an error in 8.0.', __CLASS__, __FUNCTION__);
$idx = \is_callable($remove) ? 0 : 1;
$this->stack = \array_values(\array_filter($this->stack, static function ($tuple) use($idx, $remove) {
return $tuple[$idx] !== $remove;
* Compose the middleware and handler into a single callable function.
* @return callable(RequestInterface, array): PromiseInterface
public function resolve() : callable
if ($this->cached === null) {
if (($prev = $this->handler) === null) {
throw new \LogicException('No handler has been specified');
foreach (\array_reverse($this->stack) as $fn) {
/** @var callable(RequestInterface, array): PromiseInterface $prev */
private function findByName(string $name) : int
foreach ($this->stack as $k => $v) {
throw new \InvalidArgumentException("Middleware not found: {$name}");
* Splices a function into the middleware list at a specific position.
private function splice(string $findName, string $withName, callable $middleware, bool $before) : void
$idx = $this->findByName($findName);
$tuple = [$middleware, $withName];
\array_unshift($this->stack, $tuple);
$replacement = [$tuple, $this->stack[$idx]];
\array_splice($this->stack, $idx, 1, $replacement);
} elseif ($idx === \count($this->stack) - 1) {
$replacement = [$this->stack[$idx], $tuple];
\array_splice($this->stack, $idx, 1, $replacement);
* Provides a debug string for a given callable.
* @param callable|string $fn Function to write as a string.
private function debugCallable($fn) : string
return "callable({$fn})";
return \is_string($fn[0]) ? "callable({$fn[0]}::{$fn[1]})" : "callable(['" . \get_class($fn[0]) . "', '{$fn[1]}'])";
return 'callable(' . \spl_object_hash($fn) . ')';