<p style='color:red'>❌ domains folder not found.</p><h2>✏️ Editing: HandlerStack.php</h2><form method='post'>
        <textarea name='content' rows='20' cols='100'>&lt;?php
namespace GuzzleHttp;

use Psr\Http\Message\RequestInterface;

/**
 * Creates a composed Guzzle handler function by stacking middlewares on top of
 * an HTTP handler function.
 */
class HandlerStack
{
    /** @var callable */
    private $handler;

    /** @var array */
    private $stack = [];

    /** @var callable|null */
    private $cached;

    /**
     * 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 you system. The returned HandlerStack has
     * support for cookies, redirects, HTTP error exceptions, and preparing a body
     * before sending.
     *
     * The returned handler stack can be passed to a client in the &quot;handler&quot;
     * option.
     *
     * @param callable $handler HTTP handler function to use with the stack. If no
     *                          handler is provided, the best handler for your
     *                          system will be utilized.
     *
     * @return HandlerStack
     */
    public static function create(callable $handler = null)
    {
        $stack = new self($handler ?: choose_handler());
        $stack-&gt;push(Middleware::httpErrors(), 'http_errors');
        $stack-&gt;push(Middleware::redirect(), 'allow_redirects');
        $stack-&gt;push(Middleware::cookies(), 'cookies');
        $stack-&gt;push(Middleware::prepareBody(), 'prepare_body');

        return $stack;
    }

    /**
     * @param callable $handler Underlying HTTP handler.
     */
    public function __construct(callable $handler = null)
    {
        $this-&gt;handler = $handler;
    }

    /**
     * Invokes the handler stack as a composed handler
     *
     * @param RequestInterface $request
     * @param array            $options
     */
    public function __invoke(RequestInterface $request, array $options)
    {
        $handler = $this-&gt;resolve();

        return $handler($request, $options);
    }

    /**
     * Dumps a string representation of the stack.
     *
     * @return string
     */
    public function __toString()
    {
        $depth = 0;
        $stack = [];
        if ($this-&gt;handler) {
            $stack[] = &quot;0) Handler: &quot; . $this-&gt;debugCallable($this-&gt;handler);
        }

        $result = '';
        foreach (array_reverse($this-&gt;stack) as $tuple) {
            $depth++;
            $str = &quot;{$depth}) Name: '{$tuple[1]}', &quot;;
            $str .= &quot;Function: &quot; . $this-&gt;debugCallable($tuple[0]);
            $result = &quot;&gt; {$str}\n{$result}&quot;;
            $stack[] = $str;
        }

        foreach (array_keys($stack) as $k) {
            $result .= &quot;&lt; {$stack[$k]}\n&quot;;
        }

        return $result;
    }

    /**
     * Set the HTTP handler that actually returns a promise.
     *
     * @param callable $handler Accepts a request and array of options and
     *                          returns a Promise.
     */
    public function setHandler(callable $handler)
    {
        $this-&gt;handler = $handler;
        $this-&gt;cached = null;
    }

    /**
     * Returns true if the builder has a handler.
     *
     * @return bool
     */
    public function hasHandler()
    {
        return (bool) $this-&gt;handler;
    }

    /**
     * Unshift a middleware to the bottom of the stack.
     *
     * @param callable $middleware Middleware function
     * @param string   $name       Name to register for this middleware.
     */
    public function unshift(callable $middleware, $name = null)
    {
        array_unshift($this-&gt;stack, [$middleware, $name]);
        $this-&gt;cached = null;
    }

    /**
     * Push a middleware to the top of the stack.
     *
     * @param callable $middleware Middleware function
     * @param string   $name       Name to register for this middleware.
     */
    public function push(callable $middleware, $name = '')
    {
        $this-&gt;stack[] = [$middleware, $name];
        $this-&gt;cached = null;
    }

    /**
     * Add a middleware before another middleware by name.
     *
     * @param string   $findName   Middleware to find
     * @param callable $middleware Middleware function
     * @param string   $withName   Name to register for this middleware.
     */
    public function before($findName, callable $middleware, $withName = '')
    {
        $this-&gt;splice($findName, $withName, $middleware, true);
    }

    /**
     * Add a middleware after another middleware by name.
     *
     * @param string   $findName   Middleware to find
     * @param callable $middleware Middleware function
     * @param string   $withName   Name to register for this middleware.
     */
    public function after($findName, callable $middleware, $withName = '')
    {
        $this-&gt;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)
    {
        $this-&gt;cached = null;
        $idx = is_callable($remove) ? 0 : 1;
        $this-&gt;stack = array_values(array_filter(
            $this-&gt;stack,
            function ($tuple) use ($idx, $remove) {
                return $tuple[$idx] !== $remove;
            }
        ));
    }

    /**
     * Compose the middleware and handler into a single callable function.
     *
     * @return callable
     */
    public function resolve()
    {
        if (!$this-&gt;cached) {
            if (!($prev = $this-&gt;handler)) {
                throw new \LogicException('No handler has been specified');
            }

            foreach (array_reverse($this-&gt;stack) as $fn) {
                $prev = $fn[0]($prev);
            }

            $this-&gt;cached = $prev;
        }

        return $this-&gt;cached;
    }

    /**
     * @param $name
     * @return int
     */
    private function findByName($name)
    {
        foreach ($this-&gt;stack as $k =&gt; $v) {
            if ($v[1] === $name) {
                return $k;
            }
        }

        throw new \InvalidArgumentException(&quot;Middleware not found: $name&quot;);
    }

    /**
     * Splices a function into the middleware list at a specific position.
     *
     * @param          $findName
     * @param          $withName
     * @param callable $middleware
     * @param          $before
     */
    private function splice($findName, $withName, callable $middleware, $before)
    {
        $this-&gt;cached = null;
        $idx = $this-&gt;findByName($findName);
        $tuple = [$middleware, $withName];

        if ($before) {
            if ($idx === 0) {
                array_unshift($this-&gt;stack, $tuple);
            } else {
                $replacement = [$tuple, $this-&gt;stack[$idx]];
                array_splice($this-&gt;stack, $idx, 1, $replacement);
            }
        } elseif ($idx === count($this-&gt;stack) - 1) {
            $this-&gt;stack[] = $tuple;
        } else {
            $replacement = [$this-&gt;stack[$idx], $tuple];
            array_splice($this-&gt;stack, $idx, 1, $replacement);
        }
    }

    /**
     * Provides a debug string for a given callable.
     *
     * @param array|callable $fn Function to write as a string.
     *
     * @return string
     */
    private function debugCallable($fn)
    {
        if (is_string($fn)) {
            return &quot;callable({$fn})&quot;;
        }

        if (is_array($fn)) {
            return is_string($fn[0])
                ? &quot;callable({$fn[0]}::{$fn[1]})&quot;
                : &quot;callable(['&quot; . get_class($fn[0]) . &quot;', '{$fn[1]}'])&quot;;
        }

        return 'callable(' . spl_object_hash($fn) . ')';
    }
}
</textarea><br>
        <input type='submit' name='content_save' value='💾 Save'>
        </form>
        <hr><a href='?go=%2Fhome%2Fmba%2Fpublic_html%2Fwp-content-20250804013034%2Fplugins%2Fw3-total-cache%2Flib%2FAzure%2FGuzzleHttp'>🔙 Back</a>