class FileCookieJar in Lockr 7.3

Persists non-session cookies using a JSON formatted file

Hierarchy

• class \GuzzleHttp\Cookie\CookieJar implements CookieJarInterface
  • class \GuzzleHttp\Cookie\FileCookieJar

File

vendor/guzzlehttp/guzzle/src/Cookie/FileCookieJar.php, line 7

Namespace

GuzzleHttp\Cookie

class FileCookieJar extends CookieJar {

  /** @var string filename */
  private $filename;

  /** @var bool Control whether to persist session cookies or not. */
  private $storeSessionCookies;

  /**
   * Create a new FileCookieJar object
   *
   * @param string $cookieFile        File to store the cookie data
   * @param bool $storeSessionCookies Set to true to store session cookies
   *                                  in the cookie jar.
   *
   * @throws \RuntimeException if the file cannot be found or created
   */
  public function __construct($cookieFile, $storeSessionCookies = false) {
    $this->filename = $cookieFile;
    $this->storeSessionCookies = $storeSessionCookies;
    if (file_exists($cookieFile)) {
      $this
        ->load($cookieFile);
    }
  }

  /**
   * Saves the file when shutting down
   */
  public function __destruct() {
    $this
      ->save($this->filename);
  }

  /**
   * Saves the cookies to a file.
   *
   * @param string $filename File to save
   * @throws \RuntimeException if the file cannot be found or created
   */
  public function save($filename) {
    $json = [];
    foreach ($this as $cookie) {

      /** @var SetCookie $cookie */
      if (CookieJar::shouldPersist($cookie, $this->storeSessionCookies)) {
        $json[] = $cookie
          ->toArray();
      }
    }
    $jsonStr = \GuzzleHttp\json_encode($json);
    if (false === file_put_contents($filename, $jsonStr)) {
      throw new \RuntimeException("Unable to save file {$filename}");
    }
  }

  /**
   * Load cookies from a JSON formatted file.
   *
   * Old cookies are kept unless overwritten by newly loaded ones.
   *
   * @param string $filename Cookie file to load.
   * @throws \RuntimeException if the file cannot be loaded.
   */
  public function load($filename) {
    $json = file_get_contents($filename);
    if (false === $json) {
      throw new \RuntimeException("Unable to load file {$filename}");
    }
    elseif ($json === '') {
      return;
    }
    $data = \GuzzleHttp\json_decode($json, true);
    if (is_array($data)) {
      foreach (json_decode($json, true) as $cookie) {
        $this
          ->setCookie(new SetCookie($cookie));
      }
    }
    elseif (strlen($data)) {
      throw new \RuntimeException("Invalid cookie file: {$filename}");
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
CookieJar::$cookies	private	property	@var SetCookie[] Loaded cookie data
CookieJar::$strictMode	private	property	@var bool
CookieJar::clear	public	function	Remove cookies currently held in the cookie jar. Overrides CookieJarInterface::clear
CookieJar::clearSessionCookies	public	function	Discard all sessions cookies. Overrides CookieJarInterface::clearSessionCookies
CookieJar::count	public	function
CookieJar::extractCookies	public	function	Extract cookies from an HTTP response and store them in the CookieJar. Overrides CookieJarInterface::extractCookies
CookieJar::fromArray	public static	function	Create a new Cookie jar from an associative array and domain.
CookieJar::getCookieByName	public	function	Finds and returns the cookie based on the name
CookieJar::getCookiePathFromRequest	private	function	Computes cookie path following RFC 6265 section 5.1.4
CookieJar::getCookieValue	public static	function
CookieJar::getIterator	public	function
CookieJar::removeCookieIfEmpty	private	function	If a cookie already exists and the server asks to set it again with a null value, the cookie must be deleted.
CookieJar::setCookie	public	function	Sets a cookie in the cookie jar. Overrides CookieJarInterface::setCookie
CookieJar::shouldPersist	public static	function	Evaluate if this cookie should be persisted to storage that survives between requests.
CookieJar::toArray	public	function	Converts the cookie jar to an array. Overrides CookieJarInterface::toArray
CookieJar::withCookieHeader	public	function	Create a request with added cookie headers. Overrides CookieJarInterface::withCookieHeader
FileCookieJar::$filename	private	property	@var string filename
FileCookieJar::$storeSessionCookies	private	property	@var bool Control whether to persist session cookies or not.
FileCookieJar::load	public	function	Load cookies from a JSON formatted file.
FileCookieJar::save	public	function	Saves the cookies to a file.
FileCookieJar::__construct	public	function	Create a new FileCookieJar object Overrides CookieJar::__construct
FileCookieJar::__destruct	public	function	Saves the file when shutting down