ParserCacheFactory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Parser;
 
use BagOStuff;
use IBufferingStatsdDataFactory;
use MediaWiki\Config\ServiceOptions;
use MediaWiki\HookContainer\HookContainer;
use MediaWiki\Json\JsonCodec;
use ParserCache;
use Psr\Log\LoggerInterface;
use WANObjectCache;
 
class ParserCacheFactory {
 
    public const DEFAULT_NAME = 'pcache';
 
    private $parserCacheBackend;
 
    private $revisionOutputCacheBackend;
 
    private $hookContainer;
 
    private $jsonCodec;
 
    private $stats;
 
    private $logger;
 
    private $parserCaches = [];
 
    private $revisionOutputCaches = [];
 
    private $options;
 
    public const CONSTRUCTOR_OPTIONS = [
        'ParserCacheUseJson', // Temporary feature flag, remove before 1.36 is released.
        'CacheEpoch',
        'OldRevisionParserCacheExpireTime',
    ];
 
    public function __construct(
        BagOStuff $parserCacheBackend,
        WANObjectCache $revisionOutputCacheBackend,
        HookContainer $hookContainer,
        JsonCodec $jsonCodec,
        IBufferingStatsdDataFactory $stats,
        LoggerInterface $logger,
        ServiceOptions $options
    ) {
        $this->parserCacheBackend = $parserCacheBackend;
        $this->revisionOutputCacheBackend = $revisionOutputCacheBackend;
        $this->hookContainer = $hookContainer;
        $this->jsonCodec = $jsonCodec;
        $this->stats = $stats;
        $this->logger = $logger;
 
        $options->assertRequiredOptions( self::CONSTRUCTOR_OPTIONS );
        $this->options = $options;
    }
 
    public function getParserCache( string $name ) : ParserCache {
        if ( !isset( $this->parserCaches[$name] ) ) {
            $this->logger->debug( "Creating ParserCache instance for {$name}" );
            $cache = new ParserCache(
                $name,
                $this->parserCacheBackend,
                $this->options->get( 'CacheEpoch' ),
                $this->hookContainer,
                $this->jsonCodec,
                $this->stats,
                $this->logger,
                $this->options->get( 'ParserCacheUseJson' )
            );
 
            $this->parserCaches[$name] = $cache;
        }
        return $this->parserCaches[$name];
    }
 
    public function getRevisionOutputCache( string $name ) : RevisionOutputCache {
        if ( !isset( $this->revisionOutputCaches[$name] ) ) {
            $this->logger->debug( "Creating RevisionOutputCache instance for {$name}" );
            $cache = new RevisionOutputCache(
                $name,
                $this->revisionOutputCacheBackend,
                $this->options->get( 'OldRevisionParserCacheExpireTime' ),
                $this->options->get( 'CacheEpoch' ),
                $this->jsonCodec,
                $this->stats,
                $this->logger
            );
 
            $this->revisionOutputCaches[$name] = $cache;
        }
        return $this->revisionOutputCaches[$name];
    }
}