key = $key; } /** * {@inheritdoc} */ public function getKey() { return $this->key; } /** * {@inheritdoc} */ public function get() { return $this->isHit() ? $this->value : null; } /** * {@inheritdoc} */ public function isHit() { if (!$this->isHit) { return false; } if ($this->expiration === null) { return true; } return new \DateTime() < $this->expiration; } /** * {@inheritdoc} */ public function set($value) { $this->isHit = true; $this->value = $value; return $this; } /** * {@inheritdoc} */ public function expiresAt($expiration) { if ($this->isValidExpiration($expiration)) { $this->expiration = $expiration; return $this; } $implementationMessage = interface_exists('DateTimeInterface') ? 'implement interface DateTimeInterface' : 'be an instance of DateTime'; $error = sprintf( 'Argument 1 passed to %s::expiresAt() must %s, %s given', get_class($this), $implementationMessage, gettype($expiration) ); $this->handleError($error); } /** * {@inheritdoc} */ public function expiresAfter($time) { if (is_int($time)) { $this->expiration = new \DateTime("now + $time seconds"); } elseif ($time instanceof \DateInterval) { $this->expiration = (new \DateTime())->add($time); } elseif ($time === null) { $this->expiration = $time; } else { $message = 'Argument 1 passed to %s::expiresAfter() must be an ' . 'instance of DateInterval or of the type integer, %s given'; $error = sprintf($message, get_class($this), gettype($time)); $this->handleError($error); } return $this; } /** * Handles an error. * * @param string $error * @throws \TypeError */ private function handleError($error) { if (class_exists('TypeError')) { throw new \TypeError($error); } trigger_error($error, E_USER_ERROR); } /** * Determines if an expiration is valid based on the rules defined by PSR6. * * @param mixed $expiration * @return bool */ private function isValidExpiration($expiration) { if ($expiration === null) { return true; } // We test for two types here due to the fact the DateTimeInterface // was not introduced until PHP 5.5. Checking for the DateTime type as // well allows us to support 5.4. if ($expiration instanceof \DateTimeInterface) { return true; } if ($expiration instanceof \DateTime) { return true; } return false; } }