1 | <?php |
||
7 | final class NullCacheItemPool implements CacheItemPoolInterface |
||
8 | { |
||
9 | |||
10 | /** |
||
11 | * Returns a Cache Item representing the specified key. |
||
12 | * |
||
13 | * This method must always return a CacheItemInterface object, even in case of |
||
14 | * a cache miss. It MUST NOT return null. |
||
15 | * |
||
16 | * @param string $key |
||
17 | * The key for which to return the corresponding Cache Item. |
||
18 | * |
||
19 | * @throws InvalidArgumentException If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
||
20 | * MUST be thrown. |
||
21 | * |
||
22 | * @return CacheItemInterface |
||
23 | */ |
||
24 | 2 | public function getItem($key) |
|
28 | |||
29 | /** |
||
30 | * Returns a traversable set of cache items. |
||
31 | * |
||
32 | * @param array $keys |
||
33 | * An indexed array of keys of items to retrieve. |
||
34 | * |
||
35 | * @throws InvalidArgumentException If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
||
36 | * MUST be thrown. |
||
37 | * |
||
38 | * @return array|\Traversable A traversable collection of Cache Items keyed by the cache keys of |
||
39 | * each item. A Cache item will be returned for each key, even if that |
||
40 | * key is not found. However, if no keys are specified then an empty |
||
41 | * traversable MUST be returned instead. |
||
42 | */ |
||
43 | 1 | public function getItems(array $keys = []) |
|
53 | |||
54 | /** |
||
55 | * Confirms if the cache contains specified cache item. |
||
56 | * |
||
57 | * Note: This method MAY avoid retrieving the cached value for performance reasons. |
||
58 | * This could result in a race condition with CacheItemInterface::get(). To avoid |
||
59 | * such situation use CacheItemInterface::isHit() instead. |
||
60 | * |
||
61 | * @param string $key |
||
62 | * The key for which to check existence. |
||
63 | * |
||
64 | * @throws InvalidArgumentException If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
||
65 | * MUST be thrown. |
||
66 | * |
||
67 | * @return bool True if item exists in the cache, false otherwise. |
||
68 | */ |
||
69 | 1 | public function hasItem($key) |
|
73 | |||
74 | /** |
||
75 | * Deletes all items in the pool. |
||
76 | * |
||
77 | * @return bool True if the pool was successfully cleared. False if there was an error. |
||
78 | */ |
||
79 | 1 | public function clear() |
|
83 | |||
84 | /** |
||
85 | * Removes the item from the pool. |
||
86 | * |
||
87 | * @param string $key |
||
88 | * The key for which to delete |
||
89 | * |
||
90 | * @throws InvalidArgumentException If the $key string is not a legal value a \Psr\Cache\InvalidArgumentException |
||
91 | * MUST be thrown. |
||
92 | * |
||
93 | * @return bool True if the item was successfully removed. False if there was an error. |
||
94 | */ |
||
95 | 1 | public function deleteItem($key) |
|
99 | |||
100 | /** |
||
101 | * Removes multiple items from the pool. |
||
102 | * |
||
103 | * @param array $keys |
||
104 | * An array of keys that should be removed from the pool. |
||
105 | * |
||
106 | * @throws InvalidArgumentException If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException |
||
107 | * MUST be thrown. |
||
108 | * |
||
109 | * @return bool True if the items were successfully removed. False if there was an error. |
||
110 | */ |
||
111 | 1 | public function deleteItems(array $keys) |
|
115 | |||
116 | /** |
||
117 | * Persists a cache item immediately. |
||
118 | * |
||
119 | * @param CacheItemInterface $item |
||
120 | * The cache item to save. |
||
121 | * |
||
122 | * @return bool True if the item was successfully persisted. False if there was an error. |
||
123 | */ |
||
124 | 1 | public function save(CacheItemInterface $item) |
|
128 | |||
129 | /** |
||
130 | * Sets a cache item to be persisted later. |
||
131 | * |
||
132 | * @param CacheItemInterface $item |
||
133 | * The cache item to save. |
||
134 | * |
||
135 | * @return bool False if the item could not be queued or if a commit was attempted and failed. True otherwise. |
||
136 | */ |
||
137 | 1 | public function saveDeferred(CacheItemInterface $item) |
|
141 | |||
142 | /** |
||
143 | * Persists any deferred cache items. |
||
144 | * |
||
145 | * @return bool True if all not-yet-saved items were successfully saved or there were none. False otherwise. |
||
146 | */ |
||
147 | 1 | public function commit() |
|
151 | } |
||
152 |