CacheUtil::withLastModified() - Code Metrics - micheh/psr7-cache - Measure and Improve Code Quality continuously with Scrutinizer

CacheUtil::withLastModified() A
last analyzed 2016-04-15 16:35 UTC

↳ Parent: CacheUtil

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes	3
Bugs	0	Features	0

Metric	Value
c	3
b	0
f	0
dl	0
loc	4
ccs	2
cts	2
cp	1
rs	10
cc	1
eloc	2
nc	1
nop	2
crap	1

<?php
/**
 * PSR-7 Cache Helpers
 *
 * @copyright Copyright (c) 2016, Michel Hunziker <[email protected]>
 * @license http://www.opensource.org/licenses/BSD-3-Clause The BSD-3-Clause License
 */

namespace Micheh\Cache;

use DateTime;
use DateTimeZone;
use Exception;
use InvalidArgumentException;
use Micheh\Cache\Header\CacheControl;
use Micheh\Cache\Header\ResponseCacheControl;
use Psr\Http\Message\MessageInterface;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

/**
 * Util class to add cache headers to PSR-7 HTTP messages and to parse PSR-7 cache headers.
 */
class CacheUtil
{
    /**
     * Method to add a Cache-Control header to a PSR-7 response, which should enable caching.
     * Set the `private` parameter to false to enable shared caches to cache the response (for
     * example when the response is usable by everyone and does not contain individual information).
     * With the `$maxAge` parameter you can specify how many seconds a response should be cached.
     *
     * By default this method specifies a `private` cache, which caches for 10 minutes. For more
     * options use the `withCacheControl` method.
     *
     * @see withCacheControl
     *
     * @param ResponseInterface $response PSR-7 response to add the header to
     * @param bool $public True for public, false for private
     * @param int $maxAge How many seconds the response should be cached. Default: 600 (10 min)
     * @return ResponseInterface
     * @throws InvalidArgumentException If the type is invalid
     */
    public function withCache(ResponseInterface $response, $public = false, $maxAge = 600)
    {
        $control = new ResponseCacheControl();
        $control = $public ? $control->withPublic() : $control->withPrivate();
        $control = $control->withMaxAge($maxAge);

        return $this->withCacheControl($response, $control);
    }

    /**
     * Method to add a Cache-Control header to a PSR-7 response, which should prevent caching.
     * Adds `no-cache, no-store, must-revalidate`. Use the `withCacheControl` method for more
     * options.
     *
     * @see withCacheControl
     *
     * @param ResponseInterface $response PSR-7 response to prevent caching
     * @return ResponseInterface
     */
    public function withCachePrevention(ResponseInterface $response)
    {
        $control = new ResponseCacheControl();
        $control = $control->withCachePrevention();

        return $this->withCacheControl($response, $control);
    }

    /**
     * Method to add an Expires header to a PSR-7 response. Use this header if you have a specific
     * time when the representation will expire, otherwise use the more fine-tuned `Cache-Control`
     * header with the `max-age` directive. If you need to support the old HTTP/1.0 protocol and
     * want to set a relative expiration, use the `withRelativeExpires` method.
     *
     * @see withCache
     * @see withCacheControl
     * @see withRelativeExpires
     * @link https://tools.ietf.org/html/rfc7234#section-5.3
     *
     * @param ResponseInterface $response PSR-7 response to add the header to
     * @param int|string|DateTime $time UNIX timestamp, date string or DateTime object
     * @return ResponseInterface
     * @throws InvalidArgumentException If the time could not be parsed
     */
    public function withExpires(ResponseInterface $response, $time)
    {
        return $response->withHeader('Expires', $this->getTimeFromValue($time));
    }

    /**
     * Method to add a relative `Expires` header to a PSR-7 response. Use this header if want to
     * support the old HTTP/1.0 protocol and have a relative expiration time. Otherwise use the
     * `Cache-Control` header with the `max-age` directive.
     *
     * @see withCache
     * @see withCacheControl
     * @see withExpires
     * @link https://tools.ietf.org/html/rfc7234#section-5.3
     *
     * @param ResponseInterface $response PSR-7 response to add the header to
     * @param int $seconds Number of seconds the response should be cached
     * @return ResponseInterface
     * @throws InvalidArgumentException If the seconds parameter is not an integer
     */
    public function withRelativeExpires(ResponseInterface $response, $seconds)
    {
        if (!is_int($seconds)) {
            throw new InvalidArgumentException(
                'Expected an integer with the number of seconds, received ' . gettype($seconds) . '.'
            );
        }

        return $response->withHeader('Expires', $this->getTimeFromValue(time() + $seconds));
    }

    /**
     * Method to add an ETag header to a PSR-7 response. If possible, always add an ETag to a
     * response you want to cache. If the last modified time is easily accessible, use both the
     * ETag and Last-Modified header. Use a weak ETag if you want to compare if a resource is only
     * semantically the same.
     *
     * @see withLastModified
     * @link https://tools.ietf.org/html/rfc7232#section-2.3
     *
     * @param ResponseInterface $response PSR-7 response to add the header to
     * @param string $eTag ETag to add
     * @param bool $weak If the provided ETag is weak
     * @return ResponseInterface
     * @throws InvalidArgumentException if the ETag value is not valid
     */
    public function withETag(ResponseInterface $response, $eTag, $weak = false)
    {
        $eTag = '"' . trim($eTag, '"') . '"';
        if ($weak) {
            $eTag = 'W/' . $eTag;
        }

        return $response->withHeader('ETag', $eTag);
    }

    /**
     * Method to add a Last-Modified header to a PSR-7 response. Add a Last-Modified header if you
     * have an easy access to the last modified time, otherwise use only an ETag.
     *
     * The provided time can be an UNIX timestamp, a parseable string or a DateTime instance.
     *
     * @see withETag
     * @see getTimeFromValue
     * @link https://tools.ietf.org/html/rfc7232#section-2.2
     *
     * @param ResponseInterface $response PSR-7 response to add the header to
     * @param int|string|DateTime $time UNIX timestamp, date string or DateTime object
     * @return ResponseInterface
     * @throws InvalidArgumentException If the time could not be parsed
     */
    public function withLastModified(ResponseInterface $response, $time)
    {
        return $response->withHeader('Last-Modified', $this->getTimeFromValue($time));
    }

    /**
     * Method to add a Cache-Control header to the provided PSR-7 message.
     *
     * @link https://tools.ietf.org/html/rfc7234#section-5.2
     *
     * @param MessageInterface $message PSR-7 message to add the Cache-Control header to
     * @param CacheControl $cacheControl Cache-Control object to add to the message
     * @return MessageInterface The PSR-7 message with the added Cache-Control header
     * @throws InvalidArgumentException If the Cache-Control header is invalid
     */
    public function withCacheControl(MessageInterface $message, CacheControl $cacheControl)
    {
        return $message->withHeader('Cache-Control', (string) $cacheControl);
    }

    /**
     * Checks if a request has included validators (`ETag` and/or `Last-Modified` Date) which allow
     * to determine if the client has the current resource state. The method will check if the
     * `If-Match` and/or `If-Unmodified-Since` header is present.
     *
     * This method can be used for unsafe conditional requests (neither GET nor HEAD). If the
     * request did not include a state validator (method returns `false`), abort the execution and
     * return a `428` http status code (or `403` if you only want to use the original status
     * codes). If the requests includes state validators (method returns `true`), you can continue
     * and check if the client has the current state with the `hasCurrentState` method.
     *
     * @see hasCurrentState
     * @link https://tools.ietf.org/html/rfc7232#section-6
     *
     * @param RequestInterface $request PSR-7 request to check
     * @return bool True if the request includes state validators, false if it has no validators
     */
    public function hasStateValidator(RequestInterface $request)
    {
        return $request->hasHeader('If-Match') || $request->hasHeader('If-Unmodified-Since');
    }

    /**
     * Checks if the provided PSR-7 request has the current resource state. The method will check
     * the `If-Match` and `If-Modified-Since` headers with the current ETag (and/or the Last-Modified
     * date if provided). In addition, for a request which is not GET or HEAD, the method will check
     * the `If-None-Match` header.
     *
     * Use this method to check conditional unsafe requests and to prevent lost updates. If the
     * request does not have the current resource state (method returns `false`), abort and return
     * status code `412`. In contrast, if the client has the current version of the resource (method
     * returns `true`) you can safely continue the execution and update/delete the resource.
     *
     * @link https://tools.ietf.org/html/rfc7232#section-6
     *
     * @param RequestInterface $request PSR-7 request to check
     * @param string $eTag Current ETag of the resource
     * @param null|int|string|DateTime $lastModified Current Last-Modified date (optional)
     * @return bool True if the request has the current resource state, false if the state is outdated
     * @throws InvalidArgumentException If the Last-Modified date could not be parsed
     */
    public function hasCurrentState(RequestInterface $request, $eTag, $lastModified = null)
    {
        $ifMatch = $request->getHeaderLine('If-Match');
        if ($ifMatch) {
            if (!$this->matchesETag($eTag, $ifMatch, false)) {
                return false;
            }
        } else {
            $ifUnmodified = $request->getHeaderLine('If-Unmodified-Since');
            if ($ifUnmodified && !$this->matchesModified($lastModified, $ifUnmodified)) {
                return false;
            }
        }

        if (in_array($request->getMethod(), ['GET', 'HEAD'], true)) {
            return true;
        }

        $ifNoneMatch = $request->getHeaderLine('If-None-Match');
        if ($ifNoneMatch && $this->matchesETag($eTag, $ifNoneMatch, true)) {

            return false;
        }

        return true;
    }

    /**
     * Method to check if the response is not modified and the request still has a valid cache, by
     * comparing the `ETag` headers. If no `ETag` is available and the method is GET or HEAD, the
     * `Last-Modified` header is used for comparison.
     *
     * Returns `true` if the request is not modified and the cache is still valid. In this case the
     * application should return an empty response with the status code `304`. If the returned
     * value is `false`, the client either has no cached representation or has an outdated cache.
     *
     * @link https://tools.ietf.org/html/rfc7232#section-6
     *
     * @param RequestInterface $request Request to check against
     * @param ResponseInterface $response Response with ETag and/or Last-Modified header
     * @return bool True if not modified, false if invalid cache
     * @throws InvalidArgumentException If the current Last-Modified date could not be parsed
     */
    public function isNotModified(RequestInterface $request, ResponseInterface $response)
    {
        $noneMatch = $request->getHeaderLine('If-None-Match');
        if ($noneMatch) {
            return $this->matchesETag($response->getHeaderLine('ETag'), $noneMatch, true);
        }

        if (!in_array($request->getMethod(), ['GET', 'HEAD'], true)) {
            return false;
        }

        $lastModified = $response->getHeaderLine('Last-Modified');
        $modifiedSince = $request->getHeaderLine('If-Modified-Since');

        return $this->matchesModified($lastModified, $modifiedSince);
    }

    /**
     * Method to check if a response can be cached by a shared cache. The method will check if the
     * response status is cacheable and if the Cache-Control header explicitly disallows caching.
     * The method does NOT check if the response is fresh. If you want to store the response on the
     * application side, check both `isCacheable` and `isFresh`.
     *
     * @see isFresh
     * @link https://tools.ietf.org/html/rfc7234#section-3
     *
     * @param ResponseInterface $response Response to check if it is cacheable
     * @return bool True if the response is cacheable by a shared cache and false otherwise
     */
    public function isCacheable(ResponseInterface $response)
    {
        if (!in_array($response->getStatusCode(), [200, 203, 204, /*206,*/ 300, 301, 404, 405, 410, 414, 501], true)) {
            return false;
        }

        if (!$response->hasHeader('Cache-Control')) {
            return true;
        }

        $cacheControl = $this->getCacheControl($response);
        return !$cacheControl->hasNoStore() && !$cacheControl->isPrivate();
    }

    /**
     * Method to check if a response is still fresh. This is useful if you want to know if can still
     * serve a saved response or if you have to create a new response. The method returns true if the
     * lifetime of the response is available and is greater than the age of the response. If the
     * method returns false, the response is outdated and should be renewed. In case no lifetime
     * information is available (no Cache-Control and Expires header), the method returns `null`.
     *
     * @see getLifetime
     * @see getAge
     * @link https://tools.ietf.org/html/rfc7234#section-4.2
     *
     * @param ResponseInterface $response Response to check
     * @return bool|null True if the response is still fresh and false otherwise. Null if unknown
     */
    public function isFresh(ResponseInterface $response)
    {
        $lifetime = $this->getLifetime($response);
        if ($lifetime !== null) {
            return $lifetime > $this->getAge($response);
        }

        return null;
    }

    /**
     * Returns the lifetime of the provided response (how long the response should be cached once it
     * is created). The method will lookup the `s-maxage` Cache-Control directive first and fallback
     * to the `max-age` directive. If both Cache-Control directives are not available, the `Expires`
     * header is used to compute the lifetime. Returns the lifetime in seconds if available and
     * `null` if the lifetime cannot be calculated.
     *
     * @param ResponseInterface $response Response to get the lifetime from
     * @return int|null Lifetime in seconds or null if not available
     */
    public function getLifetime(ResponseInterface $response)
    {
        if ($response->hasHeader('Cache-Control')) {
            $lifetime = $this->getCacheControl($response)->getLifetime();

            if ($lifetime !== null) {
                return $lifetime;
            }
        }

        $expires = $response->getHeaderLine('Expires');
        if ($expires) {
            $now = $response->getHeaderLine('Date');
            $now = $now ? strtotime($now) : time();
            return max(0, strtotime($expires) - $now);
        }

        return null;
    }

    /**
     * Returns the age of the response (how long the response is already cached). Uses the `Age`
     * header to determine the age. If the header is not available, the `Date` header is used
     * instead. The method will return the age in seconds or `null` if the age cannot be calculated.
     *
     * @param ResponseInterface $response Response to get the age from
     * @return int|null Age in seconds or null if not available
     */
    public function getAge(ResponseInterface $response)
    {
        $age = $response->getHeaderLine('Age');
        if ($age !== '') {
            return (int) $age;
        }

        $date = $response->getHeaderLine('Date');
        if ($date) {
            return max(0, time() - strtotime($date));
        }

        return null;
    }

    /**
     * Returns a formatted timestamp of the time parameter, to use in the HTTP headers. The time
     * parameter can be an UNIX timestamp, a parseable string or a DateTime object.
     *
     * @link https://secure.php.net/manual/en/datetime.formats.php
     *
     * @param int|string|DateTime $time Timestamp, date string or DateTime object
     * @return string Formatted timestamp
     * @throws InvalidArgumentException If the time could not be parsed
     */
    protected function getTimeFromValue($time)
    {
        $format = 'D, d M Y H:i:s \G\M\T';

        if (is_int($time)) {
            return gmdate($format, $time);
        }

        if (is_string($time)) {
            try {
                $time = new DateTime($time);
            } catch (Exception $exception) {
                // if it is an invalid date string an exception is thrown below
            }
        }

        if ($time instanceof DateTime) {
            $time = clone $time;
            $time->setTimezone(new DateTimeZone('UTC'));
            return $time->format($format);
        }

        throw new InvalidArgumentException('Could not create a valid date from ' . gettype($time) . '.');
    }

    /**
     * Returns the Unix timestamp of the time parameter. The parameter can be an Unix timestamp,
     * string or a DateTime object.
     *
     * @param int|string|DateTime $time
     * @return int Unix timestamp
     * @throws InvalidArgumentException If the time could not be parsed
     */
    protected function getTimestampFromValue($time)
    {
        if (is_int($time)) {
            return $time;
        }

        if ($time instanceof DateTime) {
            return $time->getTimestamp();
        }

        if (is_string($time)) {
            return strtotime($time);
        }

        throw new InvalidArgumentException('Could not create timestamp from ' . gettype($time) . '.');
    }

    /**
     * Parses the Cache-Control header of a response and returns the Cache-Control object.
     *
     * @param ResponseInterface $response
     * @return ResponseCacheControl
     */
    protected function getCacheControl(ResponseInterface $response)
    {
        return ResponseCacheControl::fromString($response->getHeaderLine('Cache-Control'));
    }

    /**
     * Method to check if the current ETag matches the ETag of the request.
     *
     * @link https://tools.ietf.org/html/rfc7232#section-2.3.2
     *
     * @param string $currentETag The current ETag
     * @param string $requestETags The ETags from the request
     * @param bool $weak Whether to do a weak comparison (default: strong)
     * @return bool True if the current ETag matches the ETags of the request, false otherwise
     */
    private function matchesETag($currentETag, $requestETags, $weak = false)
    {
        if ($requestETags === '*') {
            return (bool) $currentETag;
        }

        if (strpos($currentETag, 'W/"') === 0) {
            if (!$weak) {
                return false;
            }
        } else {
            $currentETag = '"' . trim($currentETag, '"') . '"';
        }

        $eTags = preg_split('/\s*,\s*/', $requestETags);
        $match = in_array($currentETag, $eTags, true);
        if (!$match && $weak) {
            $other = strpos($currentETag, '"') === 0 ? 'W/' . $currentETag : substr($currentETag, 2);
            $match = in_array($other, $eTags, true);
        }

        return $match;
    }

    /**
     * Method to check if the current Last-Modified date matches the date of the request.
     *
     * @param int|string|DateTime $currentModified Current Last-Modified date
     * @param string $requestModified Last-Modified date of the request
     * @return bool True if the current date matches the date of the request, false otherwise
     * @throws InvalidArgumentException If the current date could not be parsed
     */
    private function matchesModified($currentModified, $requestModified)
    {
        if (!$currentModified) {
            return false;
        }

        return $this->getTimestampFromValue($currentModified) <= strtotime($requestModified);
    }
}


1		<?php
2		/**
3		* PSR-7 Cache Helpers
4		*
5		* @copyright Copyright (c) 2016, Michel Hunziker <[email protected]>
6		* @license http://www.opensource.org/licenses/BSD-3-Clause The BSD-3-Clause License
7		*/
8
9		namespace Micheh\Cache;
10
11		use DateTime;
12		use DateTimeZone;
13		use Exception;
14		use InvalidArgumentException;
15		use Micheh\Cache\Header\CacheControl;
16		use Micheh\Cache\Header\ResponseCacheControl;
17		use Psr\Http\Message\MessageInterface;
18		use Psr\Http\Message\RequestInterface;
19		use Psr\Http\Message\ResponseInterface;
20
21		/**
22		* Util class to add cache headers to PSR-7 HTTP messages and to parse PSR-7 cache headers.
23		*/
24		class CacheUtil
25		{
26		/**
27		* Method to add a Cache-Control header to a PSR-7 response, which should enable caching.
28		* Set the `private` parameter to false to enable shared caches to cache the response (for
29		* example when the response is usable by everyone and does not contain individual information).
30		* With the `$maxAge` parameter you can specify how many seconds a response should be cached.
31		*
32		* By default this method specifies a `private` cache, which caches for 10 minutes. For more
33		* options use the `withCacheControl` method.
34		*
35		* @see withCacheControl
36		*
37		* @param ResponseInterface $response PSR-7 response to add the header to
38		* @param bool $public True for public, false for private
39		* @param int $maxAge How many seconds the response should be cached. Default: 600 (10 min)
40		* @return ResponseInterface
41		* @throws InvalidArgumentException If the type is invalid
42		*/
43	2	public function withCache(ResponseInterface $response, $public = false, $maxAge = 600)
44		{
45	2	$control = new ResponseCacheControl();
46	2	$control = $public ? $control->withPublic() : $control->withPrivate();
47	2	$control = $control->withMaxAge($maxAge);
48
49	2	return $this->withCacheControl($response, $control);
50		}
51
52		/**
53		* Method to add a Cache-Control header to a PSR-7 response, which should prevent caching.
54		* Adds `no-cache, no-store, must-revalidate`. Use the `withCacheControl` method for more
55		* options.
56		*
57		* @see withCacheControl
58		*
59		* @param ResponseInterface $response PSR-7 response to prevent caching
60		* @return ResponseInterface
61		*/
62	1	public function withCachePrevention(ResponseInterface $response)
63		{
64	1	$control = new ResponseCacheControl();
65	1	$control = $control->withCachePrevention();
66
67	1	return $this->withCacheControl($response, $control);
68		}
69
70		/**
71		* Method to add an Expires header to a PSR-7 response. Use this header if you have a specific
72		* time when the representation will expire, otherwise use the more fine-tuned `Cache-Control`
73		* header with the `max-age` directive. If you need to support the old HTTP/1.0 protocol and
74		* want to set a relative expiration, use the `withRelativeExpires` method.
75		*
76		* @see withCache
77		* @see withCacheControl
78		* @see withRelativeExpires
79		* @link https://tools.ietf.org/html/rfc7234#section-5.3
80		*
81		* @param ResponseInterface $response PSR-7 response to add the header to
82		* @param int\|string\|DateTime $time UNIX timestamp, date string or DateTime object
83		* @return ResponseInterface
84		* @throws InvalidArgumentException If the time could not be parsed
85		*/
86	3	public function withExpires(ResponseInterface $response, $time)
87		{
88	3	return $response->withHeader('Expires', $this->getTimeFromValue($time));
89		}
90
91		/**
92		* Method to add a relative `Expires` header to a PSR-7 response. Use this header if want to
93		* support the old HTTP/1.0 protocol and have a relative expiration time. Otherwise use the
94		* `Cache-Control` header with the `max-age` directive.
95		*
96		* @see withCache
97		* @see withCacheControl
98		* @see withExpires
99		* @link https://tools.ietf.org/html/rfc7234#section-5.3
100		*
101		* @param ResponseInterface $response PSR-7 response to add the header to
102		* @param int $seconds Number of seconds the response should be cached
103		* @return ResponseInterface
104		* @throws InvalidArgumentException If the seconds parameter is not an integer
105		*/
106	2	public function withRelativeExpires(ResponseInterface $response, $seconds)
107		{
108	2	if (!is_int($seconds)) {
109	1	throw new InvalidArgumentException(
110	1	'Expected an integer with the number of seconds, received ' . gettype($seconds) . '.'
111	1	);
112		}
113
114	1	return $response->withHeader('Expires', $this->getTimeFromValue(time() + $seconds));
115		}
116
117		/**
118		* Method to add an ETag header to a PSR-7 response. If possible, always add an ETag to a
119		* response you want to cache. If the last modified time is easily accessible, use both the
120		* ETag and Last-Modified header. Use a weak ETag if you want to compare if a resource is only
121		* semantically the same.
122		*
123		* @see withLastModified
124		* @link https://tools.ietf.org/html/rfc7232#section-2.3
125		*
126		* @param ResponseInterface $response PSR-7 response to add the header to
127		* @param string $eTag ETag to add
128		* @param bool $weak If the provided ETag is weak
129		* @return ResponseInterface
130		* @throws InvalidArgumentException if the ETag value is not valid
131		*/
132	3	public function withETag(ResponseInterface $response, $eTag, $weak = false)
133		{
134	3	$eTag = '"' . trim($eTag, '"') . '"';
135	3	if ($weak) {
136	1	$eTag = 'W/' . $eTag;
137	1	}
138
139	3	return $response->withHeader('ETag', $eTag);
140		}
141
142		/**
143		* Method to add a Last-Modified header to a PSR-7 response. Add a Last-Modified header if you
144		* have an easy access to the last modified time, otherwise use only an ETag.
145		*
146		* The provided time can be an UNIX timestamp, a parseable string or a DateTime instance.
147		*
148		* @see withETag
149		* @see getTimeFromValue
150		* @link https://tools.ietf.org/html/rfc7232#section-2.2
151		*
152		* @param ResponseInterface $response PSR-7 response to add the header to
153		* @param int\|string\|DateTime $time UNIX timestamp, date string or DateTime object
154		* @return ResponseInterface
155		* @throws InvalidArgumentException If the time could not be parsed
156		*/
157	1	public function withLastModified(ResponseInterface $response, $time)
158		{
159	1	return $response->withHeader('Last-Modified', $this->getTimeFromValue($time));
160		}
161
162		/**
163		* Method to add a Cache-Control header to the provided PSR-7 message.
164		*
165		* @link https://tools.ietf.org/html/rfc7234#section-5.2
166		*
167		* @param MessageInterface $message PSR-7 message to add the Cache-Control header to
168		* @param CacheControl $cacheControl Cache-Control object to add to the message
169		* @return MessageInterface The PSR-7 message with the added Cache-Control header
170		* @throws InvalidArgumentException If the Cache-Control header is invalid
171		*/
172	1	public function withCacheControl(MessageInterface $message, CacheControl $cacheControl)
173		{
174	1	return $message->withHeader('Cache-Control', (string) $cacheControl);
175		}
176
177		/**
178		* Checks if a request has included validators (`ETag` and/or `Last-Modified` Date) which allow
179		* to determine if the client has the current resource state. The method will check if the
180		* `If-Match` and/or `If-Unmodified-Since` header is present.
181		*
182		* This method can be used for unsafe conditional requests (neither GET nor HEAD). If the
183		* request did not include a state validator (method returns `false`), abort the execution and
184		* return a `428` http status code (or `403` if you only want to use the original status
185		* codes). If the requests includes state validators (method returns `true`), you can continue
186		* and check if the client has the current state with the `hasCurrentState` method.
187		*
188		* @see hasCurrentState
189		* @link https://tools.ietf.org/html/rfc7232#section-6
190		*
191		* @param RequestInterface $request PSR-7 request to check
192		* @return bool True if the request includes state validators, false if it has no validators
193		*/
194	4	public function hasStateValidator(RequestInterface $request)
195		{
196	4	return $request->hasHeader('If-Match') \|\| $request->hasHeader('If-Unmodified-Since');
197		}
198
199		/**
200		* Checks if the provided PSR-7 request has the current resource state. The method will check
201		* the `If-Match` and `If-Modified-Since` headers with the current ETag (and/or the Last-Modified
202		* date if provided). In addition, for a request which is not GET or HEAD, the method will check
203		* the `If-None-Match` header.
204		*
205		* Use this method to check conditional unsafe requests and to prevent lost updates. If the
206		* request does not have the current resource state (method returns `false`), abort and return
207		* status code `412`. In contrast, if the client has the current version of the resource (method
208		* returns `true`) you can safely continue the execution and update/delete the resource.
209		*
210		* @link https://tools.ietf.org/html/rfc7232#section-6
211		*
212		* @param RequestInterface $request PSR-7 request to check
213		* @param string $eTag Current ETag of the resource
214		* @param null\|int\|string\|DateTime $lastModified Current Last-Modified date (optional)
215		* @return bool True if the request has the current resource state, false if the state is outdated
216		* @throws InvalidArgumentException If the Last-Modified date could not be parsed
217		*/
218	20	public function hasCurrentState(RequestInterface $request, $eTag, $lastModified = null)
219		{
220	20	$ifMatch = $request->getHeaderLine('If-Match');
221	20	if ($ifMatch) {
222	11	if (!$this->matchesETag($eTag, $ifMatch, false)) {
223	7	return false;
224		}
225	4	} else {
226	9	$ifUnmodified = $request->getHeaderLine('If-Unmodified-Since');
227	9	if ($ifUnmodified && !$this->matchesModified($lastModified, $ifUnmodified)) {
228	2	return false;
229		}
230		}
231
232	11	if (in_array($request->getMethod(), ['GET', 'HEAD'], true)) {
233	1	return true;
234		}
235
236	10	$ifNoneMatch = $request->getHeaderLine('If-None-Match');
237	10	if ($ifNoneMatch && $this->matchesETag($eTag, $ifNoneMatch, true)) {
		1 ignored issue – show Unused Code introduced 2016-04-15 16:35 UTC by Report Bug Copy Issue Report This `if` statement, and the following `return` statement can be replaced with `return !($ifNoneMatch &&..., $ifNoneMatch, true));`. Loading history...
238	2	return false;
239		}
240
241	8	return true;
242		}
243
244		/**
245		* Method to check if the response is not modified and the request still has a valid cache, by
246		* comparing the `ETag` headers. If no `ETag` is available and the method is GET or HEAD, the
247		* `Last-Modified` header is used for comparison.
248		*
249		* Returns `true` if the request is not modified and the cache is still valid. In this case the
250		* application should return an empty response with the status code `304`. If the returned
251		* value is `false`, the client either has no cached representation or has an outdated cache.
252		*
253		* @link https://tools.ietf.org/html/rfc7232#section-6
254		*
255		* @param RequestInterface $request Request to check against
256		* @param ResponseInterface $response Response with ETag and/or Last-Modified header
257		* @return bool True if not modified, false if invalid cache
258		* @throws InvalidArgumentException If the current Last-Modified date could not be parsed
259		*/
260	15	public function isNotModified(RequestInterface $request, ResponseInterface $response)
261		{
262	15	$noneMatch = $request->getHeaderLine('If-None-Match');
263	15	if ($noneMatch) {
264	10	return $this->matchesETag($response->getHeaderLine('ETag'), $noneMatch, true);
265		}
266
267	5	if (!in_array($request->getMethod(), ['GET', 'HEAD'], true)) {
268	1	return false;
269		}
270
271	4	$lastModified = $response->getHeaderLine('Last-Modified');
272	4	$modifiedSince = $request->getHeaderLine('If-Modified-Since');
273
274	4	return $this->matchesModified($lastModified, $modifiedSince);
275		}
276
277		/**
278		* Method to check if a response can be cached by a shared cache. The method will check if the
279		* response status is cacheable and if the Cache-Control header explicitly disallows caching.
280		* The method does NOT check if the response is fresh. If you want to store the response on the
281		* application side, check both `isCacheable` and `isFresh`.
282		*
283		* @see isFresh
284		* @link https://tools.ietf.org/html/rfc7234#section-3
285		*
286		* @param ResponseInterface $response Response to check if it is cacheable
287		* @return bool True if the response is cacheable by a shared cache and false otherwise
288		*/
289	4	public function isCacheable(ResponseInterface $response)
290		{
291	4	if (!in_array($response->getStatusCode(), [200, 203, 204, /206,/ 300, 301, 404, 405, 410, 414, 501], true)) {
292	1	return false;
293		}
294
295	3	if (!$response->hasHeader('Cache-Control')) {
296	1	return true;
297		}
298
299	2	$cacheControl = $this->getCacheControl($response);
300	2	return !$cacheControl->hasNoStore() && !$cacheControl->isPrivate();
301		}
302
303		/**
304		* Method to check if a response is still fresh. This is useful if you want to know if can still
305		* serve a saved response or if you have to create a new response. The method returns true if the
306		* lifetime of the response is available and is greater than the age of the response. If the
307		* method returns false, the response is outdated and should be renewed. In case no lifetime
308		* information is available (no Cache-Control and Expires header), the method returns `null`.
309		*
310		* @see getLifetime
311		* @see getAge
312		* @link https://tools.ietf.org/html/rfc7234#section-4.2
313		*
314		* @param ResponseInterface $response Response to check
315		* @return bool\|null True if the response is still fresh and false otherwise. Null if unknown
316		*/
317	4	public function isFresh(ResponseInterface $response)
318		{
319	4	$lifetime = $this->getLifetime($response);
320	4	if ($lifetime !== null) {
321	3	return $lifetime > $this->getAge($response);
322		}
323
324	1	return null;
325		}
326
327		/**
328		* Returns the lifetime of the provided response (how long the response should be cached once it
329		* is created). The method will lookup the `s-maxage` Cache-Control directive first and fallback
330		* to the `max-age` directive. If both Cache-Control directives are not available, the `Expires`
331		* header is used to compute the lifetime. Returns the lifetime in seconds if available and
332		* `null` if the lifetime cannot be calculated.
333		*
334		* @param ResponseInterface $response Response to get the lifetime from
335		* @return int\|null Lifetime in seconds or null if not available
336		*/
337	7	public function getLifetime(ResponseInterface $response)
338		{
339	7	if ($response->hasHeader('Cache-Control')) {
340	4	$lifetime = $this->getCacheControl($response)->getLifetime();
341
342	4	if ($lifetime !== null) {
343	3	return $lifetime;
344		}
345	1	}
346
347	4	$expires = $response->getHeaderLine('Expires');
348	4	if ($expires) {
349	2	$now = $response->getHeaderLine('Date');
350	2	$now = $now ? strtotime($now) : time();
351	2	return max(0, strtotime($expires) - $now);
352		}
353
354	2	return null;
355		}
356
357		/**
358		* Returns the age of the response (how long the response is already cached). Uses the `Age`
359		* header to determine the age. If the header is not available, the `Date` header is used
360		* instead. The method will return the age in seconds or `null` if the age cannot be calculated.
361		*
362		* @param ResponseInterface $response Response to get the age from
363		* @return int\|null Age in seconds or null if not available
364		*/
365	3	public function getAge(ResponseInterface $response)
366		{
367	3	$age = $response->getHeaderLine('Age');
368	3	if ($age !== '') {
369	1	return (int) $age;
370		}
371
372	2	$date = $response->getHeaderLine('Date');
373	2	if ($date) {
374	1	return max(0, time() - strtotime($date));
375		}
376
377	1	return null;
378		}
379
380		/**
381		* Returns a formatted timestamp of the time parameter, to use in the HTTP headers. The time
382		* parameter can be an UNIX timestamp, a parseable string or a DateTime object.
383		*
384		* @link https://secure.php.net/manual/en/datetime.formats.php
385		*
386		* @param int\|string\|DateTime $time Timestamp, date string or DateTime object
387		* @return string Formatted timestamp
388		* @throws InvalidArgumentException If the time could not be parsed
389		*/
390	6	protected function getTimeFromValue($time)
391		{
392	6	$format = 'D, d M Y H:i:s \G\M\T';
393
394	6	if (is_int($time)) {
395	2	return gmdate($format, $time);
396		}
397
398	4	if (is_string($time)) {
399		try {
400	2	$time = new DateTime($time);
401	2	} catch (Exception $exception) {
402		// if it is an invalid date string an exception is thrown below
403		}
404	2	}
405
406	4	if ($time instanceof DateTime) {
407	3	$time = clone $time;
408	3	$time->setTimezone(new DateTimeZone('UTC'));
409	3	return $time->format($format);
410		}
411
412	1	throw new InvalidArgumentException('Could not create a valid date from ' . gettype($time) . '.');
413		}
414
415		/**
416		* Returns the Unix timestamp of the time parameter. The parameter can be an Unix timestamp,
417		* string or a DateTime object.
418		*
419		* @param int\|string\|DateTime $time
420		* @return int Unix timestamp
421		* @throws InvalidArgumentException If the time could not be parsed
422		*/
423	4	protected function getTimestampFromValue($time)
424		{
425	4	if (is_int($time)) {
426	1	return $time;
427		}
428
429	3	if ($time instanceof DateTime) {
430	1	return $time->getTimestamp();
431		}
432
433	2	if (is_string($time)) {
434	1	return strtotime($time);
435		}
436
437	1	throw new InvalidArgumentException('Could not create timestamp from ' . gettype($time) . '.');
438		}
439
440		/**
441		* Parses the Cache-Control header of a response and returns the Cache-Control object.
442		*
443		* @param ResponseInterface $response
444		* @return ResponseCacheControl
445		*/
446	1	protected function getCacheControl(ResponseInterface $response)
447		{
448	1	return ResponseCacheControl::fromString($response->getHeaderLine('Cache-Control'));
449		}
450
451		/**
452		* Method to check if the current ETag matches the ETag of the request.
453		*
454		* @link https://tools.ietf.org/html/rfc7232#section-2.3.2
455		*
456		* @param string $currentETag The current ETag
457		* @param string $requestETags The ETags from the request
458		* @param bool $weak Whether to do a weak comparison (default: strong)
459		* @return bool True if the current ETag matches the ETags of the request, false otherwise
460		*/
461	25	private function matchesETag($currentETag, $requestETags, $weak = false)
462		{
463	25	if ($requestETags === '*') {
464	6	return (bool) $currentETag;
465		}
466
467	19	if (strpos($currentETag, 'W/"') === 0) {
468	4	if (!$weak) {
469	2	return false;
470		}
471	2	} else {
472	15	$currentETag = '"' . trim($currentETag, '"') . '"';
473		}
474
475	17	$eTags = preg_split('/\s,\s/', $requestETags);
476	17	$match = in_array($currentETag, $eTags, true);
477	17	if (!$match && $weak) {
478	5	$other = strpos($currentETag, '"') === 0 ? 'W/' . $currentETag : substr($currentETag, 2);
479	5	$match = in_array($other, $eTags, true);
480	5	}
481
482	17	return $match;
483		}
484
485		/**
486		* Method to check if the current Last-Modified date matches the date of the request.
487		*
488		* @param int\|string\|DateTime $currentModified Current Last-Modified date
489		* @param string $requestModified Last-Modified date of the request
490		* @return bool True if the current date matches the date of the request, false otherwise
491		* @throws InvalidArgumentException If the current date could not be parsed
492		*/
493	8	private function matchesModified($currentModified, $requestModified)
494		{
495	8	if (!$currentModified) {
496	1	return false;
497		}
498
499	7	return $this->getTimestampFromValue($currentModified) <= strtotime($requestModified);
500		}
501		}
502

micheh / psr7-cache

CacheUtil::withLastModified() A last analyzed 2016-04-15 16:35 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

CacheUtil::withLastModified() A
last analyzed 2016-04-15 16:35 UTC