Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. CookieJar.php

class CookieJar

Same name in this branch
  1. 11.1.x vendor/guzzlehttp/guzzle/src/Cookie/CookieJar.php \GuzzleHttp\Cookie\CookieJar

CookieJar.

@author Fabien Potencier <fabien@symfony.com>

Hierarchy

  • class \Symfony\Component\BrowserKit\CookieJar

Expanded class hierarchy of CookieJar

1 file declares its use of CookieJar
HttpKernelBrowser.php in vendor/symfony/http-kernel/HttpKernelBrowser.php

File

vendor/symfony/browser-kit/CookieJar.php, line 21

Namespace

Symfony\Component\BrowserKit
View source
class CookieJar {
    protected array $cookieJar = [];
    public function set(Cookie $cookie) : void {
        $this->cookieJar[$cookie->getDomain()][$cookie->getPath()][$cookie->getName()] = $cookie;
    }
    
    /**
     * Gets a cookie by name.
     *
     * You should never use an empty domain, but if you do so,
     * this method returns the first cookie for the given name/path
     * (this behavior ensures a BC behavior with previous versions of
     * Symfony).
     */
    public function get(string $name, string $path = '/', ?string $domain = null) : ?Cookie {
        $this->flushExpiredCookies();
        foreach ($this->cookieJar as $cookieDomain => $pathCookies) {
            if ($cookieDomain && $domain) {
                $cookieDomain = '.' . ltrim($cookieDomain, '.');
                if (!str_ends_with('.' . $domain, $cookieDomain)) {
                    continue;
                }
            }
            foreach ($pathCookies as $cookiePath => $namedCookies) {
                if (!str_starts_with($path, $cookiePath)) {
                    continue;
                }
                if (isset($namedCookies[$name])) {
                    return $namedCookies[$name];
                }
            }
        }
        return null;
    }
    
    /**
     * Removes a cookie by name.
     *
     * You should never use an empty domain, but if you do so,
     * all cookies for the given name/path expire (this behavior
     * ensures a BC behavior with previous versions of Symfony).
     */
    public function expire(string $name, ?string $path = '/', ?string $domain = null) : void {
        $path ??= '/';
        if (!$domain) {
            // an empty domain means any domain
            // this should never happen but it allows for a better BC
            $domains = array_keys($this->cookieJar);
        }
        else {
            $domains = [
                $domain,
            ];
        }
        foreach ($domains as $domain) {
            unset($this->cookieJar[$domain][$path][$name]);
            if (empty($this->cookieJar[$domain][$path])) {
                unset($this->cookieJar[$domain][$path]);
                if (empty($this->cookieJar[$domain])) {
                    unset($this->cookieJar[$domain]);
                }
            }
        }
    }
    
    /**
     * Removes all the cookies from the jar.
     */
    public function clear() : void {
        $this->cookieJar = [];
    }
    
    /**
     * Updates the cookie jar from a response Set-Cookie headers.
     *
     * @param string[] $setCookies Set-Cookie headers from an HTTP response
     */
    public function updateFromSetCookie(array $setCookies, ?string $uri = null) : void {
        $cookies = [];
        foreach ($setCookies as $cookie) {
            foreach (explode(',', $cookie) as $i => $part) {
                if (0 === $i || preg_match('/^(?P<token>\\s*[0-9A-Za-z!#\\$%\\&\'\\*\\+\\-\\.^_`\\|~]+)=/', $part)) {
                    $cookies[] = ltrim($part);
                }
                else {
                    $cookies[\count($cookies) - 1] .= ',' . $part;
                }
            }
        }
        foreach ($cookies as $cookie) {
            try {
                $this->set(Cookie::fromString($cookie, $uri));
            } catch (InvalidArgumentException) {
                // invalid cookies are just ignored
            }
        }
    }
    
    /**
     * Updates the cookie jar from a Response object.
     */
    public function updateFromResponse(Response $response, ?string $uri = null) : void {
        $this->updateFromSetCookie($response->getHeader('Set-Cookie', false), $uri);
    }
    
    /**
     * Returns not yet expired cookies.
     *
     * @return Cookie[]
     */
    public function all() : array {
        $this->flushExpiredCookies();
        $flattenedCookies = [];
        foreach ($this->cookieJar as $path) {
            foreach ($path as $cookies) {
                foreach ($cookies as $cookie) {
                    $flattenedCookies[] = $cookie;
                }
            }
        }
        return $flattenedCookies;
    }
    
    /**
     * Returns not yet expired cookie values for the given URI.
     */
    public function allValues(string $uri, bool $returnsRawValue = false) : array {
        $this->flushExpiredCookies();
        $parts = array_replace([
            'path' => '/',
        ], parse_url($uri));
        $cookies = [];
        foreach ($this->cookieJar as $domain => $pathCookies) {
            if ($domain) {
                $domain = '.' . ltrim($domain, '.');
                if (!str_ends_with('.' . $parts['host'], $domain)) {
                    continue;
                }
            }
            foreach ($pathCookies as $path => $namedCookies) {
                if (!str_starts_with($parts['path'], $path)) {
                    continue;
                }
                foreach ($namedCookies as $cookie) {
                    if ($cookie->isSecure() && 'https' !== $parts['scheme']) {
                        continue;
                    }
                    $cookies[$cookie->getName()] = $returnsRawValue ? $cookie->getRawValue() : $cookie->getValue();
                }
            }
        }
        return $cookies;
    }
    
    /**
     * Returns not yet expired raw cookie values for the given URI.
     */
    public function allRawValues(string $uri) : array {
        return $this->allValues($uri, true);
    }
    
    /**
     * Removes all expired cookies.
     */
    public function flushExpiredCookies() : void {
        foreach ($this->cookieJar as $domain => $pathCookies) {
            foreach ($pathCookies as $path => $namedCookies) {
                foreach ($namedCookies as $name => $cookie) {
                    if ($cookie->isExpired()) {
                        unset($this->cookieJar[$domain][$path][$name]);
                    }
                }
            }
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary
CookieJar::$cookieJar protected property
CookieJar::all public function Returns not yet expired cookies.
CookieJar::allRawValues public function Returns not yet expired raw cookie values for the given URI.
CookieJar::allValues public function Returns not yet expired cookie values for the given URI.
CookieJar::clear public function Removes all the cookies from the jar.
CookieJar::expire public function Removes a cookie by name.
CookieJar::flushExpiredCookies public function Removes all expired cookies.
CookieJar::get public function Gets a cookie by name.
CookieJar::set public function
CookieJar::updateFromResponse public function Updates the cookie jar from a Response object.
CookieJar::updateFromSetCookie public function Updates the cookie jar from a response Set-Cookie headers.

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal