3 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
4 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
5 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
6 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
7 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
8 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
9 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
10 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
11 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
12 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
13 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
15 * This software consists of voluntary contributions made by many individuals
16 * and is licensed under the MIT license. For more information, see
17 * <http://www.doctrine-project.org>.
20 namespace Doctrine\Common\Cache;
23 * Cache provider that allows to easily chain multiple cache providers
25 * @author Michaƫl Gallego <mic.gallego@gmail.com>
27 class ChainCache extends CacheProvider
30 * @var CacheProvider[]
32 private $cacheProviders = [];
37 * @param CacheProvider[] $cacheProviders
39 public function __construct($cacheProviders = [])
41 $this->cacheProviders = $cacheProviders instanceof \Traversable
42 ? iterator_to_array($cacheProviders, false)
43 : array_values($cacheProviders);
49 public function setNamespace($namespace)
51 parent::setNamespace($namespace);
53 foreach ($this->cacheProviders as $cacheProvider) {
54 $cacheProvider->setNamespace($namespace);
61 protected function doFetch($id)
63 foreach ($this->cacheProviders as $key => $cacheProvider) {
64 if ($cacheProvider->doContains($id)) {
65 $value = $cacheProvider->doFetch($id);
67 // We populate all the previous cache layers (that are assumed to be faster)
68 for ($subKey = $key - 1 ; $subKey >= 0 ; $subKey--) {
69 $this->cacheProviders[$subKey]->doSave($id, $value);
82 protected function doFetchMultiple(array $keys)
84 /* @var $traversedProviders CacheProvider[] */
85 $traversedProviders = [];
86 $keysCount = count($keys);
89 foreach ($this->cacheProviders as $key => $cacheProvider) {
90 $fetchedValues = $cacheProvider->doFetchMultiple($keys);
92 // We populate all the previous cache layers (that are assumed to be faster)
93 if (count($fetchedValues) === $keysCount) {
94 foreach ($traversedProviders as $previousCacheProvider) {
95 $previousCacheProvider->doSaveMultiple($fetchedValues);
98 return $fetchedValues;
101 $traversedProviders[] = $cacheProvider;
104 return $fetchedValues;
110 protected function doContains($id)
112 foreach ($this->cacheProviders as $cacheProvider) {
113 if ($cacheProvider->doContains($id)) {
124 protected function doSave($id, $data, $lifeTime = 0)
128 foreach ($this->cacheProviders as $cacheProvider) {
129 $stored = $cacheProvider->doSave($id, $data, $lifeTime) && $stored;
138 protected function doSaveMultiple(array $keysAndValues, $lifetime = 0)
142 foreach ($this->cacheProviders as $cacheProvider) {
143 $stored = $cacheProvider->doSaveMultiple($keysAndValues, $lifetime) && $stored;
152 protected function doDelete($id)
156 foreach ($this->cacheProviders as $cacheProvider) {
157 $deleted = $cacheProvider->doDelete($id) && $deleted;
166 protected function doDeleteMultiple(array $keys)
170 foreach ($this->cacheProviders as $cacheProvider) {
171 $deleted = $cacheProvider->doDeleteMultiple($keys) && $deleted;
180 protected function doFlush()
184 foreach ($this->cacheProviders as $cacheProvider) {
185 $flushed = $cacheProvider->doFlush() && $flushed;
194 protected function doGetStats()
196 // We return all the stats from all adapters
199 foreach ($this->cacheProviders as $cacheProvider) {
200 $stats[] = $cacheProvider->doGetStats();