9.5/_wincache_backend_8php_source.html

<?php

namespace ‪TYPO3\CMS\Core\Cache\Backend;


/*

 * This file is part of the TYPO3 CMS project.

 *

 * It is free software; you can redistribute it and/or modify it under

 * the terms of the GNU General Public License, either version 2

 * of the License, or any later version.

 *

 * For the full copyright and license information, please read the

 * LICENSE.txt file that was distributed with this source code.

 *

 * The TYPO3 project - inspiring people to share!

 */


use ‪TYPO3\CMS\Core\Cache\Exception;

use ‪TYPO3\CMS\Core\Cache\Exception\InvalidDataException;

use ‪TYPO3\CMS\Core\Cache\Frontend\FrontendInterface;


class ‪WincacheBackend extends ‪AbstractBackend implements ‪TaggableBackendInterface

{

    protected ‪$identifierPrefix;


    public function ‪__construct(‪$context, array $options = [])

    {

        if (!extension_loaded('wincache')) {

            throw new ‪Exception('The PHP extension "wincache" must be installed and loaded in order to use the wincache backend.', 1343331520);

        }

        parent::__construct(‪$context, $options);

    }


    public function set($entryIdentifier, $data, array $tags = [], $lifetime = null)

    {

        if (!$this->cache instanceof ‪FrontendInterface) {

            throw new ‪Exception('No cache frontend has been set yet via setCache().', 1343331521);

        }

        if (!is_string($data)) {

            throw new ‪InvalidDataException('The specified data is of type "' . gettype($data) . '" but a string is expected.', 1343331522);

        }

        $tags[] = '%WCBE%' . $this->cache->getIdentifier();

        $expiration = $lifetime ?? ‪$this->defaultLifetime;

        $success = wincache_ucache_set($this->identifierPrefix . $entryIdentifier, $data, $expiration);

        if ($success === true) {

            $this->‪removeIdentifierFromAllTags($entryIdentifier);

            $this->‪addIdentifierToTags($entryIdentifier, $tags);

        } else {

            throw new ‪Exception('Could not set value.', 1343331523);

        }

    }


    public function get($entryIdentifier)

    {

        $success = false;

        $value = wincache_ucache_get($this->identifierPrefix . $entryIdentifier, $success);

        return $success ? $value : $success;

    }


    public function ‪has($entryIdentifier)

    {

        return wincache_ucache_exists($this->identifierPrefix . $entryIdentifier);

    }


    public function remove($entryIdentifier)

    {

        $this->‪removeIdentifierFromAllTags($entryIdentifier);

        return wincache_ucache_delete($this->identifierPrefix . $entryIdentifier);

    }


    public function ‪findIdentifiersByTag($tag)

    {

        $success = false;

        $identifiers = wincache_ucache_get($this->identifierPrefix . 'tag_' . $tag, $success);

        if ($success === false) {

            return [];

        }

        return (array)$identifiers;

    }


    protected function ‪findTagsByIdentifier($identifier)

    {

        $success = false;

        $tags = wincache_ucache_get($this->identifierPrefix . 'ident_' . $identifier, $success);

        return $success ? (array)$tags : [];

    }


    public function ‪flush()

    {

        if (!$this->cache instanceof ‪FrontendInterface) {

            throw new ‪Exception('Yet no cache frontend has been set via setCache().', 1343331524);

        }

        $this->‪flushByTag('%WCBE%' . $this->cache->getIdentifier());

    }


    public function ‪flushByTag($tag)

    {

        $identifiers = $this->‪findIdentifiersByTag($tag);

        foreach ($identifiers as $identifier) {

            $this->remove($identifier);

        }

    }


    protected function ‪addIdentifierToTags($entryIdentifier, array $tags)

    {

        // Get identifier-to-tag index to look for updates

        $existingTags = $this->‪findTagsByIdentifier($entryIdentifier);

        $existingTagsUpdated = false;


        foreach ($tags as $tag) {

            // Update tag-to-identifier index

            $identifiers = $this->‪findIdentifiersByTag($tag);

            if (!in_array($entryIdentifier, $identifiers, true)) {

                $identifiers[] = $entryIdentifier;

                wincache_ucache_set($this->identifierPrefix . 'tag_' . $tag, $identifiers);

            }

            // Test if identifier-to-tag index needs update

            if (!in_array($tag, $existingTags, true)) {

                $existingTags[] = $tag;

                $existingTagsUpdated = true;

            }

        }


        // Update identifier-to-tag index if needed

        if ($existingTagsUpdated) {

            wincache_ucache_set($this->identifierPrefix . 'ident_' . $entryIdentifier, $existingTags);

        }

    }


    protected function ‪removeIdentifierFromAllTags($entryIdentifier)

    {

        // Get tags for this identifier

        $tags = $this->‪findTagsByIdentifier($entryIdentifier);

        // Deassociate tags with this identifier

        foreach ($tags as $tag) {

            $identifiers = $this->‪findIdentifiersByTag($tag);

            // Formally array_search() below should never return false due to

            // the behavior of findTagsByIdentifier(). But if reverse index is

            // corrupted, we still can get 'false' from array_search(). This is

            // not a problem because we are removing this identifier from

            // anywhere.

            if (($key = array_search($entryIdentifier, $identifiers)) !== false) {

                unset($identifiers[$key]);

                if (!empty($identifiers)) {

                    wincache_ucache_set($this->identifierPrefix . 'tag_' . $tag, $identifiers);

                } else {

                    wincache_ucache_delete($this->identifierPrefix . 'tag_' . $tag);

                }

            }

        }

        // Clear reverse tag index for this identifier

        wincache_ucache_delete($this->identifierPrefix . 'ident_' . $entryIdentifier);

    }


    public function ‪collectGarbage()

    {

    }

}