Preprocessor.php

Go to the documentation of this file.

<?php
use MediaWiki\Logger\LoggerFactory;
use MediaWiki\MediaWikiServices;
 
abstract class Preprocessor {
 
    public const CACHE_VERSION = 1;
 
    public $parser;
 
    protected $rules = [
        '{' => [
            'end' => '}',
            'names' => [
                2 => 'template',
                3 => 'tplarg',
            ],
            'min' => 2,
            'max' => 3,
        ],
        '[' => [
            'end' => ']',
            'names' => [ 2 => null ],
            'min' => 2,
            'max' => 2,
        ],
        '-{' => [
            'end' => '}-',
            'names' => [ 2 => null ],
            'min' => 2,
            'max' => 2,
        ],
    ];
 
    protected function cacheSetTree( $text, $flags, $tree ) {
        $config = RequestContext::getMain()->getConfig();
 
        $length = strlen( $text );
        $threshold = $config->get( 'PreprocessorCacheThreshold' );
        if ( $threshold === false || $length < $threshold || $length > 1e6 ) {
            return;
        }
 
        $cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
        $key = $cache->makeKey(
            // @phan-suppress-next-line PhanUndeclaredConstantOfClass
            defined( 'static::CACHE_PREFIX' ) ? static::CACHE_PREFIX : static::class,
            md5( $text ),
            $flags
        );
        $value = sprintf( "%08d", static::CACHE_VERSION ) . $tree;
 
        $cache->set( $key, $value, 86400 );
 
        LoggerFactory::getInstance( 'Preprocessor' )
            ->info( "Cached preprocessor output (key: $key)" );
    }
 
    protected function cacheGetTree( $text, $flags ) {
        $config = RequestContext::getMain()->getConfig();
 
        $length = strlen( $text );
        $threshold = $config->get( 'PreprocessorCacheThreshold' );
        if ( $threshold === false || $length < $threshold || $length > 1e6 ) {
            return false;
        }
 
        $cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
 
        $key = $cache->makeKey(
            // @phan-suppress-next-line PhanUndeclaredConstantOfClass
            defined( 'static::CACHE_PREFIX' ) ? static::CACHE_PREFIX : static::class,
            md5( $text ),
            $flags
        );
 
        $value = $cache->get( $key );
        if ( !$value ) {
            return false;
        }
 
        $version = intval( substr( $value, 0, 8 ) );
        if ( $version !== static::CACHE_VERSION ) {
            return false;
        }
 
        LoggerFactory::getInstance( 'Preprocessor' )
            ->info( "Loaded preprocessor output from cache (key: $key)" );
 
        return substr( $value, 8 );
    }
 
    abstract public function newFrame();
 
    abstract public function newCustomFrame( $args );
 
    abstract public function newPartNodeArray( $values );
 
    abstract public function preprocessToObj( $text, $flags = 0 );
}