@@ -6,7 +6,7 @@ |
||
6 | 6 | $baseDir = dirname($vendorDir); |
7 | 7 | |
8 | 8 | return array( |
9 | - 'Psr\\SimpleCache\\' => array($vendorDir . '/psr/simple-cache/src'), |
|
10 | - 'Psr\\Cache\\' => array($vendorDir . '/psr/cache/src'), |
|
11 | - 'Phpfastcache\\' => array($vendorDir . '/phpfastcache/phpfastcache/lib/Phpfastcache'), |
|
9 | + 'Psr\\SimpleCache\\' => array($vendorDir . '/psr/simple-cache/src'), |
|
10 | + 'Psr\\Cache\\' => array($vendorDir . '/psr/cache/src'), |
|
11 | + 'Phpfastcache\\' => array($vendorDir . '/phpfastcache/phpfastcache/lib/Phpfastcache'), |
|
12 | 12 | ); |
@@ -5,22 +5,22 @@ |
||
5 | 5 | $issues = array(); |
6 | 6 | |
7 | 7 | if (!(PHP_VERSION_ID >= 80000)) { |
8 | - $issues[] = 'Your Composer dependencies require a PHP version ">= 8.0.0". You are running ' . PHP_VERSION . '.'; |
|
8 | + $issues[] = 'Your Composer dependencies require a PHP version ">= 8.0.0". You are running ' . PHP_VERSION . '.'; |
|
9 | 9 | } |
10 | 10 | |
11 | 11 | if ($issues) { |
12 | - if (!headers_sent()) { |
|
13 | - header('HTTP/1.1 500 Internal Server Error'); |
|
14 | - } |
|
15 | - if (!ini_get('display_errors')) { |
|
16 | - if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { |
|
17 | - fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL); |
|
18 | - } elseif (!headers_sent()) { |
|
19 | - echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL; |
|
20 | - } |
|
21 | - } |
|
22 | - trigger_error( |
|
23 | - 'Composer detected issues in your platform: ' . implode(' ', $issues), |
|
24 | - E_USER_ERROR |
|
25 | - ); |
|
12 | + if (!headers_sent()) { |
|
13 | + header('HTTP/1.1 500 Internal Server Error'); |
|
14 | + } |
|
15 | + if (!ini_get('display_errors')) { |
|
16 | + if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { |
|
17 | + fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL); |
|
18 | + } elseif (!headers_sent()) { |
|
19 | + echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL; |
|
20 | + } |
|
21 | + } |
|
22 | + trigger_error( |
|
23 | + 'Composer detected issues in your platform: ' . implode(' ', $issues), |
|
24 | + E_USER_ERROR |
|
25 | + ); |
|
26 | 26 | } |
@@ -1,62 +1,62 @@ |
||
1 | 1 | <?php return array( |
2 | - 'root' => array( |
|
3 | - 'pretty_version' => 'dev-master', |
|
4 | - 'version' => 'dev-master', |
|
5 | - 'type' => 'library', |
|
6 | - 'install_path' => __DIR__ . '/../../', |
|
7 | - 'aliases' => array(), |
|
8 | - 'reference' => '6c6efb9ff6f27eadaaff9e3cbfc83fc277ef8b66', |
|
9 | - 'name' => '__root__', |
|
10 | - 'dev' => true, |
|
11 | - ), |
|
12 | - 'versions' => array( |
|
13 | - '__root__' => array( |
|
14 | - 'pretty_version' => 'dev-master', |
|
15 | - 'version' => 'dev-master', |
|
16 | - 'type' => 'library', |
|
17 | - 'install_path' => __DIR__ . '/../../', |
|
18 | - 'aliases' => array(), |
|
19 | - 'reference' => '6c6efb9ff6f27eadaaff9e3cbfc83fc277ef8b66', |
|
20 | - 'dev_requirement' => false, |
|
21 | - ), |
|
22 | - 'phpfastcache/phpfastcache' => array( |
|
23 | - 'pretty_version' => '9.2.3', |
|
24 | - 'version' => '9.2.3.0', |
|
25 | - 'type' => 'library', |
|
26 | - 'install_path' => __DIR__ . '/../phpfastcache/phpfastcache', |
|
27 | - 'aliases' => array(), |
|
28 | - 'reference' => '372d62e0bbab5bcfac6404dc912040b038a3afb7', |
|
29 | - 'dev_requirement' => false, |
|
30 | - ), |
|
31 | - 'psr/cache' => array( |
|
32 | - 'pretty_version' => '3.0.0', |
|
33 | - 'version' => '3.0.0.0', |
|
34 | - 'type' => 'library', |
|
35 | - 'install_path' => __DIR__ . '/../psr/cache', |
|
36 | - 'aliases' => array(), |
|
37 | - 'reference' => 'aa5030cfa5405eccfdcb1083ce040c2cb8d253bf', |
|
38 | - 'dev_requirement' => false, |
|
39 | - ), |
|
40 | - 'psr/cache-implementation' => array( |
|
41 | - 'dev_requirement' => false, |
|
42 | - 'provided' => array( |
|
43 | - 0 => '2.0|3.0', |
|
44 | - ), |
|
45 | - ), |
|
46 | - 'psr/simple-cache' => array( |
|
47 | - 'pretty_version' => '3.0.0', |
|
48 | - 'version' => '3.0.0.0', |
|
49 | - 'type' => 'library', |
|
50 | - 'install_path' => __DIR__ . '/../psr/simple-cache', |
|
51 | - 'aliases' => array(), |
|
52 | - 'reference' => '764e0b3939f5ca87cb904f570ef9be2d78a07865', |
|
53 | - 'dev_requirement' => false, |
|
54 | - ), |
|
55 | - 'psr/simple-cache-implementation' => array( |
|
56 | - 'dev_requirement' => false, |
|
57 | - 'provided' => array( |
|
58 | - 0 => '2.0|3.0', |
|
59 | - ), |
|
60 | - ), |
|
61 | - ), |
|
2 | + 'root' => array( |
|
3 | + 'pretty_version' => 'dev-master', |
|
4 | + 'version' => 'dev-master', |
|
5 | + 'type' => 'library', |
|
6 | + 'install_path' => __DIR__ . '/../../', |
|
7 | + 'aliases' => array(), |
|
8 | + 'reference' => '6c6efb9ff6f27eadaaff9e3cbfc83fc277ef8b66', |
|
9 | + 'name' => '__root__', |
|
10 | + 'dev' => true, |
|
11 | + ), |
|
12 | + 'versions' => array( |
|
13 | + '__root__' => array( |
|
14 | + 'pretty_version' => 'dev-master', |
|
15 | + 'version' => 'dev-master', |
|
16 | + 'type' => 'library', |
|
17 | + 'install_path' => __DIR__ . '/../../', |
|
18 | + 'aliases' => array(), |
|
19 | + 'reference' => '6c6efb9ff6f27eadaaff9e3cbfc83fc277ef8b66', |
|
20 | + 'dev_requirement' => false, |
|
21 | + ), |
|
22 | + 'phpfastcache/phpfastcache' => array( |
|
23 | + 'pretty_version' => '9.2.3', |
|
24 | + 'version' => '9.2.3.0', |
|
25 | + 'type' => 'library', |
|
26 | + 'install_path' => __DIR__ . '/../phpfastcache/phpfastcache', |
|
27 | + 'aliases' => array(), |
|
28 | + 'reference' => '372d62e0bbab5bcfac6404dc912040b038a3afb7', |
|
29 | + 'dev_requirement' => false, |
|
30 | + ), |
|
31 | + 'psr/cache' => array( |
|
32 | + 'pretty_version' => '3.0.0', |
|
33 | + 'version' => '3.0.0.0', |
|
34 | + 'type' => 'library', |
|
35 | + 'install_path' => __DIR__ . '/../psr/cache', |
|
36 | + 'aliases' => array(), |
|
37 | + 'reference' => 'aa5030cfa5405eccfdcb1083ce040c2cb8d253bf', |
|
38 | + 'dev_requirement' => false, |
|
39 | + ), |
|
40 | + 'psr/cache-implementation' => array( |
|
41 | + 'dev_requirement' => false, |
|
42 | + 'provided' => array( |
|
43 | + 0 => '2.0|3.0', |
|
44 | + ), |
|
45 | + ), |
|
46 | + 'psr/simple-cache' => array( |
|
47 | + 'pretty_version' => '3.0.0', |
|
48 | + 'version' => '3.0.0.0', |
|
49 | + 'type' => 'library', |
|
50 | + 'install_path' => __DIR__ . '/../psr/simple-cache', |
|
51 | + 'aliases' => array(), |
|
52 | + 'reference' => '764e0b3939f5ca87cb904f570ef9be2d78a07865', |
|
53 | + 'dev_requirement' => false, |
|
54 | + ), |
|
55 | + 'psr/simple-cache-implementation' => array( |
|
56 | + 'dev_requirement' => false, |
|
57 | + 'provided' => array( |
|
58 | + 0 => '2.0|3.0', |
|
59 | + ), |
|
60 | + ), |
|
61 | + ), |
|
62 | 62 | ); |
@@ -23,83 +23,83 @@ |
||
23 | 23 | */ |
24 | 24 | interface CacheItemInterface |
25 | 25 | { |
26 | - /** |
|
27 | - * Returns the key for the current cache item. |
|
28 | - * |
|
29 | - * The key is loaded by the Implementing Library, but should be available to |
|
30 | - * the higher level callers when needed. |
|
31 | - * |
|
32 | - * @return string |
|
33 | - * The key string for this cache item. |
|
34 | - */ |
|
35 | - public function getKey(): string; |
|
26 | + /** |
|
27 | + * Returns the key for the current cache item. |
|
28 | + * |
|
29 | + * The key is loaded by the Implementing Library, but should be available to |
|
30 | + * the higher level callers when needed. |
|
31 | + * |
|
32 | + * @return string |
|
33 | + * The key string for this cache item. |
|
34 | + */ |
|
35 | + public function getKey(): string; |
|
36 | 36 | |
37 | - /** |
|
38 | - * Retrieves the value of the item from the cache associated with this object's key. |
|
39 | - * |
|
40 | - * The value returned must be identical to the value originally stored by set(). |
|
41 | - * |
|
42 | - * If isHit() returns false, this method MUST return null. Note that null |
|
43 | - * is a legitimate cached value, so the isHit() method SHOULD be used to |
|
44 | - * differentiate between "null value was found" and "no value was found." |
|
45 | - * |
|
46 | - * @return mixed |
|
47 | - * The value corresponding to this cache item's key, or null if not found. |
|
48 | - */ |
|
49 | - public function get(): mixed; |
|
37 | + /** |
|
38 | + * Retrieves the value of the item from the cache associated with this object's key. |
|
39 | + * |
|
40 | + * The value returned must be identical to the value originally stored by set(). |
|
41 | + * |
|
42 | + * If isHit() returns false, this method MUST return null. Note that null |
|
43 | + * is a legitimate cached value, so the isHit() method SHOULD be used to |
|
44 | + * differentiate between "null value was found" and "no value was found." |
|
45 | + * |
|
46 | + * @return mixed |
|
47 | + * The value corresponding to this cache item's key, or null if not found. |
|
48 | + */ |
|
49 | + public function get(): mixed; |
|
50 | 50 | |
51 | - /** |
|
52 | - * Confirms if the cache item lookup resulted in a cache hit. |
|
53 | - * |
|
54 | - * Note: This method MUST NOT have a race condition between calling isHit() |
|
55 | - * and calling get(). |
|
56 | - * |
|
57 | - * @return bool |
|
58 | - * True if the request resulted in a cache hit. False otherwise. |
|
59 | - */ |
|
60 | - public function isHit(): bool; |
|
51 | + /** |
|
52 | + * Confirms if the cache item lookup resulted in a cache hit. |
|
53 | + * |
|
54 | + * Note: This method MUST NOT have a race condition between calling isHit() |
|
55 | + * and calling get(). |
|
56 | + * |
|
57 | + * @return bool |
|
58 | + * True if the request resulted in a cache hit. False otherwise. |
|
59 | + */ |
|
60 | + public function isHit(): bool; |
|
61 | 61 | |
62 | - /** |
|
63 | - * Sets the value represented by this cache item. |
|
64 | - * |
|
65 | - * The $value argument may be any item that can be serialized by PHP, |
|
66 | - * although the method of serialization is left up to the Implementing |
|
67 | - * Library. |
|
68 | - * |
|
69 | - * @param mixed $value |
|
70 | - * The serializable value to be stored. |
|
71 | - * |
|
72 | - * @return static |
|
73 | - * The invoked object. |
|
74 | - */ |
|
75 | - public function set(mixed $value): static; |
|
62 | + /** |
|
63 | + * Sets the value represented by this cache item. |
|
64 | + * |
|
65 | + * The $value argument may be any item that can be serialized by PHP, |
|
66 | + * although the method of serialization is left up to the Implementing |
|
67 | + * Library. |
|
68 | + * |
|
69 | + * @param mixed $value |
|
70 | + * The serializable value to be stored. |
|
71 | + * |
|
72 | + * @return static |
|
73 | + * The invoked object. |
|
74 | + */ |
|
75 | + public function set(mixed $value): static; |
|
76 | 76 | |
77 | - /** |
|
78 | - * Sets the expiration time for this cache item. |
|
79 | - * |
|
80 | - * @param ?\DateTimeInterface $expiration |
|
81 | - * The point in time after which the item MUST be considered expired. |
|
82 | - * If null is passed explicitly, a default value MAY be used. If none is set, |
|
83 | - * the value should be stored permanently or for as long as the |
|
84 | - * implementation allows. |
|
85 | - * |
|
86 | - * @return static |
|
87 | - * The called object. |
|
88 | - */ |
|
89 | - public function expiresAt(?\DateTimeInterface $expiration): static; |
|
77 | + /** |
|
78 | + * Sets the expiration time for this cache item. |
|
79 | + * |
|
80 | + * @param ?\DateTimeInterface $expiration |
|
81 | + * The point in time after which the item MUST be considered expired. |
|
82 | + * If null is passed explicitly, a default value MAY be used. If none is set, |
|
83 | + * the value should be stored permanently or for as long as the |
|
84 | + * implementation allows. |
|
85 | + * |
|
86 | + * @return static |
|
87 | + * The called object. |
|
88 | + */ |
|
89 | + public function expiresAt(?\DateTimeInterface $expiration): static; |
|
90 | 90 | |
91 | - /** |
|
92 | - * Sets the expiration time for this cache item. |
|
93 | - * |
|
94 | - * @param int|\DateInterval|null $time |
|
95 | - * The period of time from the present after which the item MUST be considered |
|
96 | - * expired. An integer parameter is understood to be the time in seconds until |
|
97 | - * expiration. If null is passed explicitly, a default value MAY be used. |
|
98 | - * If none is set, the value should be stored permanently or for as long as the |
|
99 | - * implementation allows. |
|
100 | - * |
|
101 | - * @return static |
|
102 | - * The called object. |
|
103 | - */ |
|
104 | - public function expiresAfter(int|\DateInterval|null $time): static; |
|
91 | + /** |
|
92 | + * Sets the expiration time for this cache item. |
|
93 | + * |
|
94 | + * @param int|\DateInterval|null $time |
|
95 | + * The period of time from the present after which the item MUST be considered |
|
96 | + * expired. An integer parameter is understood to be the time in seconds until |
|
97 | + * expiration. If null is passed explicitly, a default value MAY be used. |
|
98 | + * If none is set, the value should be stored permanently or for as long as the |
|
99 | + * implementation allows. |
|
100 | + * |
|
101 | + * @return static |
|
102 | + * The called object. |
|
103 | + */ |
|
104 | + public function expiresAfter(int|\DateInterval|null $time): static; |
|
105 | 105 | } |
@@ -13,126 +13,126 @@ |
||
13 | 13 | */ |
14 | 14 | interface CacheItemPoolInterface |
15 | 15 | { |
16 | - /** |
|
17 | - * Returns a Cache Item representing the specified key. |
|
18 | - * |
|
19 | - * This method must always return a CacheItemInterface object, even in case of |
|
20 | - * a cache miss. It MUST NOT return null. |
|
21 | - * |
|
22 | - * @param string $key |
|
23 | - * The key for which to return the corresponding Cache Item. |
|
24 | - * |
|
25 | - * @throws InvalidArgumentException |
|
26 | - * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
27 | - * MUST be thrown. |
|
28 | - * |
|
29 | - * @return CacheItemInterface |
|
30 | - * The corresponding Cache Item. |
|
31 | - */ |
|
32 | - public function getItem(string $key): CacheItemInterface; |
|
16 | + /** |
|
17 | + * Returns a Cache Item representing the specified key. |
|
18 | + * |
|
19 | + * This method must always return a CacheItemInterface object, even in case of |
|
20 | + * a cache miss. It MUST NOT return null. |
|
21 | + * |
|
22 | + * @param string $key |
|
23 | + * The key for which to return the corresponding Cache Item. |
|
24 | + * |
|
25 | + * @throws InvalidArgumentException |
|
26 | + * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
27 | + * MUST be thrown. |
|
28 | + * |
|
29 | + * @return CacheItemInterface |
|
30 | + * The corresponding Cache Item. |
|
31 | + */ |
|
32 | + public function getItem(string $key): CacheItemInterface; |
|
33 | 33 | |
34 | - /** |
|
35 | - * Returns a traversable set of cache items. |
|
36 | - * |
|
37 | - * @param string[] $keys |
|
38 | - * An indexed array of keys of items to retrieve. |
|
39 | - * |
|
40 | - * @throws InvalidArgumentException |
|
41 | - * If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
|
42 | - * MUST be thrown. |
|
43 | - * |
|
44 | - * @return iterable |
|
45 | - * An iterable collection of Cache Items keyed by the cache keys of |
|
46 | - * each item. A Cache item will be returned for each key, even if that |
|
47 | - * key is not found. However, if no keys are specified then an empty |
|
48 | - * traversable MUST be returned instead. |
|
49 | - */ |
|
50 | - public function getItems(array $keys = []): iterable; |
|
34 | + /** |
|
35 | + * Returns a traversable set of cache items. |
|
36 | + * |
|
37 | + * @param string[] $keys |
|
38 | + * An indexed array of keys of items to retrieve. |
|
39 | + * |
|
40 | + * @throws InvalidArgumentException |
|
41 | + * If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
|
42 | + * MUST be thrown. |
|
43 | + * |
|
44 | + * @return iterable |
|
45 | + * An iterable collection of Cache Items keyed by the cache keys of |
|
46 | + * each item. A Cache item will be returned for each key, even if that |
|
47 | + * key is not found. However, if no keys are specified then an empty |
|
48 | + * traversable MUST be returned instead. |
|
49 | + */ |
|
50 | + public function getItems(array $keys = []): iterable; |
|
51 | 51 | |
52 | - /** |
|
53 | - * Confirms if the cache contains specified cache item. |
|
54 | - * |
|
55 | - * Note: This method MAY avoid retrieving the cached value for performance reasons. |
|
56 | - * This could result in a race condition with CacheItemInterface::get(). To avoid |
|
57 | - * such situation use CacheItemInterface::isHit() instead. |
|
58 | - * |
|
59 | - * @param string $key |
|
60 | - * The key for which to check existence. |
|
61 | - * |
|
62 | - * @throws InvalidArgumentException |
|
63 | - * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
64 | - * MUST be thrown. |
|
65 | - * |
|
66 | - * @return bool |
|
67 | - * True if item exists in the cache, false otherwise. |
|
68 | - */ |
|
69 | - public function hasItem(string $key): bool; |
|
52 | + /** |
|
53 | + * Confirms if the cache contains specified cache item. |
|
54 | + * |
|
55 | + * Note: This method MAY avoid retrieving the cached value for performance reasons. |
|
56 | + * This could result in a race condition with CacheItemInterface::get(). To avoid |
|
57 | + * such situation use CacheItemInterface::isHit() instead. |
|
58 | + * |
|
59 | + * @param string $key |
|
60 | + * The key for which to check existence. |
|
61 | + * |
|
62 | + * @throws InvalidArgumentException |
|
63 | + * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
64 | + * MUST be thrown. |
|
65 | + * |
|
66 | + * @return bool |
|
67 | + * True if item exists in the cache, false otherwise. |
|
68 | + */ |
|
69 | + public function hasItem(string $key): bool; |
|
70 | 70 | |
71 | - /** |
|
72 | - * Deletes all items in the pool. |
|
73 | - * |
|
74 | - * @return bool |
|
75 | - * True if the pool was successfully cleared. False if there was an error. |
|
76 | - */ |
|
77 | - public function clear(): bool; |
|
71 | + /** |
|
72 | + * Deletes all items in the pool. |
|
73 | + * |
|
74 | + * @return bool |
|
75 | + * True if the pool was successfully cleared. False if there was an error. |
|
76 | + */ |
|
77 | + public function clear(): bool; |
|
78 | 78 | |
79 | - /** |
|
80 | - * Removes the item from the pool. |
|
81 | - * |
|
82 | - * @param string $key |
|
83 | - * The key to delete. |
|
84 | - * |
|
85 | - * @throws InvalidArgumentException |
|
86 | - * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
87 | - * MUST be thrown. |
|
88 | - * |
|
89 | - * @return bool |
|
90 | - * True if the item was successfully removed. False if there was an error. |
|
91 | - */ |
|
92 | - public function deleteItem(string $key): bool; |
|
79 | + /** |
|
80 | + * Removes the item from the pool. |
|
81 | + * |
|
82 | + * @param string $key |
|
83 | + * The key to delete. |
|
84 | + * |
|
85 | + * @throws InvalidArgumentException |
|
86 | + * If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
|
87 | + * MUST be thrown. |
|
88 | + * |
|
89 | + * @return bool |
|
90 | + * True if the item was successfully removed. False if there was an error. |
|
91 | + */ |
|
92 | + public function deleteItem(string $key): bool; |
|
93 | 93 | |
94 | - /** |
|
95 | - * Removes multiple items from the pool. |
|
96 | - * |
|
97 | - * @param string[] $keys |
|
98 | - * An array of keys that should be removed from the pool. |
|
99 | - * |
|
100 | - * @throws InvalidArgumentException |
|
101 | - * If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
|
102 | - * MUST be thrown. |
|
103 | - * |
|
104 | - * @return bool |
|
105 | - * True if the items were successfully removed. False if there was an error. |
|
106 | - */ |
|
107 | - public function deleteItems(array $keys): bool; |
|
94 | + /** |
|
95 | + * Removes multiple items from the pool. |
|
96 | + * |
|
97 | + * @param string[] $keys |
|
98 | + * An array of keys that should be removed from the pool. |
|
99 | + * |
|
100 | + * @throws InvalidArgumentException |
|
101 | + * If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
|
102 | + * MUST be thrown. |
|
103 | + * |
|
104 | + * @return bool |
|
105 | + * True if the items were successfully removed. False if there was an error. |
|
106 | + */ |
|
107 | + public function deleteItems(array $keys): bool; |
|
108 | 108 | |
109 | - /** |
|
110 | - * Persists a cache item immediately. |
|
111 | - * |
|
112 | - * @param CacheItemInterface $item |
|
113 | - * The cache item to save. |
|
114 | - * |
|
115 | - * @return bool |
|
116 | - * True if the item was successfully persisted. False if there was an error. |
|
117 | - */ |
|
118 | - public function save(CacheItemInterface $item): bool; |
|
109 | + /** |
|
110 | + * Persists a cache item immediately. |
|
111 | + * |
|
112 | + * @param CacheItemInterface $item |
|
113 | + * The cache item to save. |
|
114 | + * |
|
115 | + * @return bool |
|
116 | + * True if the item was successfully persisted. False if there was an error. |
|
117 | + */ |
|
118 | + public function save(CacheItemInterface $item): bool; |
|
119 | 119 | |
120 | - /** |
|
121 | - * Sets a cache item to be persisted later. |
|
122 | - * |
|
123 | - * @param CacheItemInterface $item |
|
124 | - * The cache item to save. |
|
125 | - * |
|
126 | - * @return bool |
|
127 | - * False if the item could not be queued or if a commit was attempted and failed. True otherwise. |
|
128 | - */ |
|
129 | - public function saveDeferred(CacheItemInterface $item): bool; |
|
120 | + /** |
|
121 | + * Sets a cache item to be persisted later. |
|
122 | + * |
|
123 | + * @param CacheItemInterface $item |
|
124 | + * The cache item to save. |
|
125 | + * |
|
126 | + * @return bool |
|
127 | + * False if the item could not be queued or if a commit was attempted and failed. True otherwise. |
|
128 | + */ |
|
129 | + public function saveDeferred(CacheItemInterface $item): bool; |
|
130 | 130 | |
131 | - /** |
|
132 | - * Persists any deferred cache items. |
|
133 | - * |
|
134 | - * @return bool |
|
135 | - * True if all not-yet-saved items were successfully saved or there were none. False otherwise. |
|
136 | - */ |
|
137 | - public function commit(): bool; |
|
131 | + /** |
|
132 | + * Persists any deferred cache items. |
|
133 | + * |
|
134 | + * @return bool |
|
135 | + * True if all not-yet-saved items were successfully saved or there were none. False otherwise. |
|
136 | + */ |
|
137 | + public function commit(): bool; |
|
138 | 138 | } |
@@ -4,111 +4,111 @@ |
||
4 | 4 | |
5 | 5 | interface CacheInterface |
6 | 6 | { |
7 | - /** |
|
8 | - * Fetches a value from the cache. |
|
9 | - * |
|
10 | - * @param string $key The unique key of this item in the cache. |
|
11 | - * @param mixed $default Default value to return if the key does not exist. |
|
12 | - * |
|
13 | - * @return mixed The value of the item from the cache, or $default in case of cache miss. |
|
14 | - * |
|
15 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
16 | - * MUST be thrown if the $key string is not a legal value. |
|
17 | - */ |
|
18 | - public function get(string $key, mixed $default = null): mixed; |
|
7 | + /** |
|
8 | + * Fetches a value from the cache. |
|
9 | + * |
|
10 | + * @param string $key The unique key of this item in the cache. |
|
11 | + * @param mixed $default Default value to return if the key does not exist. |
|
12 | + * |
|
13 | + * @return mixed The value of the item from the cache, or $default in case of cache miss. |
|
14 | + * |
|
15 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
16 | + * MUST be thrown if the $key string is not a legal value. |
|
17 | + */ |
|
18 | + public function get(string $key, mixed $default = null): mixed; |
|
19 | 19 | |
20 | - /** |
|
21 | - * Persists data in the cache, uniquely referenced by a key with an optional expiration TTL time. |
|
22 | - * |
|
23 | - * @param string $key The key of the item to store. |
|
24 | - * @param mixed $value The value of the item to store, must be serializable. |
|
25 | - * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and |
|
26 | - * the driver supports TTL then the library may set a default value |
|
27 | - * for it or let the driver take care of that. |
|
28 | - * |
|
29 | - * @return bool True on success and false on failure. |
|
30 | - * |
|
31 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
32 | - * MUST be thrown if the $key string is not a legal value. |
|
33 | - */ |
|
34 | - public function set(string $key, mixed $value, null|int|\DateInterval $ttl = null): bool; |
|
20 | + /** |
|
21 | + * Persists data in the cache, uniquely referenced by a key with an optional expiration TTL time. |
|
22 | + * |
|
23 | + * @param string $key The key of the item to store. |
|
24 | + * @param mixed $value The value of the item to store, must be serializable. |
|
25 | + * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and |
|
26 | + * the driver supports TTL then the library may set a default value |
|
27 | + * for it or let the driver take care of that. |
|
28 | + * |
|
29 | + * @return bool True on success and false on failure. |
|
30 | + * |
|
31 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
32 | + * MUST be thrown if the $key string is not a legal value. |
|
33 | + */ |
|
34 | + public function set(string $key, mixed $value, null|int|\DateInterval $ttl = null): bool; |
|
35 | 35 | |
36 | - /** |
|
37 | - * Delete an item from the cache by its unique key. |
|
38 | - * |
|
39 | - * @param string $key The unique cache key of the item to delete. |
|
40 | - * |
|
41 | - * @return bool True if the item was successfully removed. False if there was an error. |
|
42 | - * |
|
43 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
44 | - * MUST be thrown if the $key string is not a legal value. |
|
45 | - */ |
|
46 | - public function delete(string $key): bool; |
|
36 | + /** |
|
37 | + * Delete an item from the cache by its unique key. |
|
38 | + * |
|
39 | + * @param string $key The unique cache key of the item to delete. |
|
40 | + * |
|
41 | + * @return bool True if the item was successfully removed. False if there was an error. |
|
42 | + * |
|
43 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
44 | + * MUST be thrown if the $key string is not a legal value. |
|
45 | + */ |
|
46 | + public function delete(string $key): bool; |
|
47 | 47 | |
48 | - /** |
|
49 | - * Wipes clean the entire cache's keys. |
|
50 | - * |
|
51 | - * @return bool True on success and false on failure. |
|
52 | - */ |
|
53 | - public function clear(): bool; |
|
48 | + /** |
|
49 | + * Wipes clean the entire cache's keys. |
|
50 | + * |
|
51 | + * @return bool True on success and false on failure. |
|
52 | + */ |
|
53 | + public function clear(): bool; |
|
54 | 54 | |
55 | - /** |
|
56 | - * Obtains multiple cache items by their unique keys. |
|
57 | - * |
|
58 | - * @param iterable<string> $keys A list of keys that can be obtained in a single operation. |
|
59 | - * @param mixed $default Default value to return for keys that do not exist. |
|
60 | - * |
|
61 | - * @return iterable<string, mixed> A list of key => value pairs. Cache keys that do not exist or are stale will have $default as value. |
|
62 | - * |
|
63 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
64 | - * MUST be thrown if $keys is neither an array nor a Traversable, |
|
65 | - * or if any of the $keys are not a legal value. |
|
66 | - */ |
|
67 | - public function getMultiple(iterable $keys, mixed $default = null): iterable; |
|
55 | + /** |
|
56 | + * Obtains multiple cache items by their unique keys. |
|
57 | + * |
|
58 | + * @param iterable<string> $keys A list of keys that can be obtained in a single operation. |
|
59 | + * @param mixed $default Default value to return for keys that do not exist. |
|
60 | + * |
|
61 | + * @return iterable<string, mixed> A list of key => value pairs. Cache keys that do not exist or are stale will have $default as value. |
|
62 | + * |
|
63 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
64 | + * MUST be thrown if $keys is neither an array nor a Traversable, |
|
65 | + * or if any of the $keys are not a legal value. |
|
66 | + */ |
|
67 | + public function getMultiple(iterable $keys, mixed $default = null): iterable; |
|
68 | 68 | |
69 | - /** |
|
70 | - * Persists a set of key => value pairs in the cache, with an optional TTL. |
|
71 | - * |
|
72 | - * @param iterable $values A list of key => value pairs for a multiple-set operation. |
|
73 | - * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and |
|
74 | - * the driver supports TTL then the library may set a default value |
|
75 | - * for it or let the driver take care of that. |
|
76 | - * |
|
77 | - * @return bool True on success and false on failure. |
|
78 | - * |
|
79 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
80 | - * MUST be thrown if $values is neither an array nor a Traversable, |
|
81 | - * or if any of the $values are not a legal value. |
|
82 | - */ |
|
83 | - public function setMultiple(iterable $values, null|int|\DateInterval $ttl = null): bool; |
|
69 | + /** |
|
70 | + * Persists a set of key => value pairs in the cache, with an optional TTL. |
|
71 | + * |
|
72 | + * @param iterable $values A list of key => value pairs for a multiple-set operation. |
|
73 | + * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and |
|
74 | + * the driver supports TTL then the library may set a default value |
|
75 | + * for it or let the driver take care of that. |
|
76 | + * |
|
77 | + * @return bool True on success and false on failure. |
|
78 | + * |
|
79 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
80 | + * MUST be thrown if $values is neither an array nor a Traversable, |
|
81 | + * or if any of the $values are not a legal value. |
|
82 | + */ |
|
83 | + public function setMultiple(iterable $values, null|int|\DateInterval $ttl = null): bool; |
|
84 | 84 | |
85 | - /** |
|
86 | - * Deletes multiple cache items in a single operation. |
|
87 | - * |
|
88 | - * @param iterable<string> $keys A list of string-based keys to be deleted. |
|
89 | - * |
|
90 | - * @return bool True if the items were successfully removed. False if there was an error. |
|
91 | - * |
|
92 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
93 | - * MUST be thrown if $keys is neither an array nor a Traversable, |
|
94 | - * or if any of the $keys are not a legal value. |
|
95 | - */ |
|
96 | - public function deleteMultiple(iterable $keys): bool; |
|
85 | + /** |
|
86 | + * Deletes multiple cache items in a single operation. |
|
87 | + * |
|
88 | + * @param iterable<string> $keys A list of string-based keys to be deleted. |
|
89 | + * |
|
90 | + * @return bool True if the items were successfully removed. False if there was an error. |
|
91 | + * |
|
92 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
93 | + * MUST be thrown if $keys is neither an array nor a Traversable, |
|
94 | + * or if any of the $keys are not a legal value. |
|
95 | + */ |
|
96 | + public function deleteMultiple(iterable $keys): bool; |
|
97 | 97 | |
98 | - /** |
|
99 | - * Determines whether an item is present in the cache. |
|
100 | - * |
|
101 | - * NOTE: It is recommended that has() is only to be used for cache warming type purposes |
|
102 | - * and not to be used within your live applications operations for get/set, as this method |
|
103 | - * is subject to a race condition where your has() will return true and immediately after, |
|
104 | - * another script can remove it making the state of your app out of date. |
|
105 | - * |
|
106 | - * @param string $key The cache item key. |
|
107 | - * |
|
108 | - * @return bool |
|
109 | - * |
|
110 | - * @throws \Psr\SimpleCache\InvalidArgumentException |
|
111 | - * MUST be thrown if the $key string is not a legal value. |
|
112 | - */ |
|
113 | - public function has(string $key): bool; |
|
98 | + /** |
|
99 | + * Determines whether an item is present in the cache. |
|
100 | + * |
|
101 | + * NOTE: It is recommended that has() is only to be used for cache warming type purposes |
|
102 | + * and not to be used within your live applications operations for get/set, as this method |
|
103 | + * is subject to a race condition where your has() will return true and immediately after, |
|
104 | + * another script can remove it making the state of your app out of date. |
|
105 | + * |
|
106 | + * @param string $key The cache item key. |
|
107 | + * |
|
108 | + * @return bool |
|
109 | + * |
|
110 | + * @throws \Psr\SimpleCache\InvalidArgumentException |
|
111 | + * MUST be thrown if the $key string is not a legal value. |
|
112 | + */ |
|
113 | + public function has(string $key): bool; |
|
114 | 114 | } |
@@ -20,8 +20,8 @@ |
||
20 | 20 | |
21 | 21 | class Item extends ItemAbstract |
22 | 22 | { |
23 | - protected function getDriverClass(): string |
|
24 | - { |
|
25 | - return Driver::class; |
|
26 | - } |
|
23 | + protected function getDriverClass(): string |
|
24 | + { |
|
25 | + return Driver::class; |
|
26 | + } |
|
27 | 27 | } |
@@ -20,8 +20,8 @@ |
||
20 | 20 | |
21 | 21 | class Item extends ItemAbstract |
22 | 22 | { |
23 | - protected function getDriverClass(): string |
|
24 | - { |
|
25 | - return Driver::class; |
|
26 | - } |
|
23 | + protected function getDriverClass(): string |
|
24 | + { |
|
25 | + return Driver::class; |
|
26 | + } |
|
27 | 27 | } |
@@ -20,8 +20,8 @@ |
||
20 | 20 | |
21 | 21 | class Item extends ItemAbstract |
22 | 22 | { |
23 | - protected function getDriverClass(): string |
|
24 | - { |
|
25 | - return Driver::class; |
|
26 | - } |
|
23 | + protected function getDriverClass(): string |
|
24 | + { |
|
25 | + return Driver::class; |
|
26 | + } |
|
27 | 27 | } |