@@ -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 | } |