You are here

interface CookieJarInterface in Zircon Profile 8.0

Same name and namespace in other branches
  1. 8 vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php \GuzzleHttp\Cookie\CookieJarInterface

Stores HTTP cookies.

It extracts cookies from HTTP requests, and returns them in HTTP responses. CookieJarInterface instances automatically expire contained cookies when necessary. Subclasses are also responsible for storing and retrieving cookies from a file, database, etc.

@link http://docs.python.org/2/library/cookielib.html Inspiration

Hierarchy

  • interface \GuzzleHttp\Cookie\CookieJarInterface extends \GuzzleHttp\Cookie\Countable \GuzzleHttp\Cookie\IteratorAggregate

Expanded class hierarchy of CookieJarInterface

All classes that implement CookieJarInterface

1 file declares its use of CookieJarInterface
Middleware.php in vendor/guzzlehttp/guzzle/src/Middleware.php

File

vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php, line 17

Namespace

GuzzleHttp\Cookie
View source
interface CookieJarInterface extends \Countable, \IteratorAggregate {

  /**
   * Create a request with added cookie headers.
   *
   * If no matching cookies are found in the cookie jar, then no Cookie
   * header is added to the request and the same request is returned.
   *
   * @param RequestInterface $request Request object to modify.
   *
   * @return RequestInterface returns the modified request.
   */
  public function withCookieHeader(RequestInterface $request);

  /**
   * Extract cookies from an HTTP response and store them in the CookieJar.
   *
   * @param RequestInterface  $request  Request that was sent
   * @param ResponseInterface $response Response that was received
   */
  public function extractCookies(RequestInterface $request, ResponseInterface $response);

  /**
   * Sets a cookie in the cookie jar.
   *
   * @param SetCookie $cookie Cookie to set.
   *
   * @return bool Returns true on success or false on failure
   */
  public function setCookie(SetCookie $cookie);

  /**
   * Remove cookies currently held in the cookie jar.
   *
   * Invoking this method without arguments will empty the whole cookie jar.
   * If given a $domain argument only cookies belonging to that domain will
   * be removed. If given a $domain and $path argument, cookies belonging to
   * the specified path within that domain are removed. If given all three
   * arguments, then the cookie with the specified name, path and domain is
   * removed.
   *
   * @param string $domain Clears cookies matching a domain
   * @param string $path   Clears cookies matching a domain and path
   * @param string $name   Clears cookies matching a domain, path, and name
   *
   * @return CookieJarInterface
   */
  public function clear($domain = null, $path = null, $name = null);

  /**
   * Discard all sessions cookies.
   *
   * Removes cookies that don't have an expire field or a have a discard
   * field set to true. To be called when the user agent shuts down according
   * to RFC 2965.
   */
  public function clearSessionCookies();

  /**
   * Converts the cookie jar to an array.
   *
   * @return array
   */
  public function toArray();

}

Members

Namesort descending Modifiers Type Description Overrides
CookieJarInterface::clear public function Remove cookies currently held in the cookie jar. 1
CookieJarInterface::clearSessionCookies public function Discard all sessions cookies. 1
CookieJarInterface::extractCookies public function Extract cookies from an HTTP response and store them in the CookieJar. 1
CookieJarInterface::setCookie public function Sets a cookie in the cookie jar. 1
CookieJarInterface::toArray public function Converts the cookie jar to an array. 1
CookieJarInterface::withCookieHeader public function Create a request with added cookie headers. 1