ParserCache.php

Go to the documentation of this file.

<?php
class ParserCache {
    private $mMemc;
    public static function singleton() {
        static $instance;
        if ( !isset( $instance ) ) {
            global $parserMemc;
            $instance = new ParserCache( $parserMemc );
        }
        return $instance;
    }

    protected function __construct( BagOStuff $memCached ) {
        $this->mMemc = $memCached;
    }

    protected function getParserOutputKey( $article, $hash ) {
        global $wgRequest;

        // idhash seem to mean 'page id' + 'rendering hash' (r3710)
        $pageid = $article->getId();
        $renderkey = (int)( $wgRequest->getVal( 'action' ) == 'render' );

        $key = wfMemcKey( 'pcache', 'idhash', "{$pageid}-{$renderkey}!{$hash}" );
        return $key;
    }

    protected function getOptionsKey( $page ) {
        return wfMemcKey( 'pcache', 'idoptions', $page->getId() );
    }

    public function deleteOptionsKey( $page ) {
        $this->mMemc->delete( $this->getOptionsKey( $page ) );
    }

    public function getETag( $article, $popts ) {
        return 'W/"' . $this->getParserOutputKey( $article,
            $popts->optionsHash( ParserOptions::legacyOptions(), $article->getTitle() ) ) .
                "--" . $article->getTouched() . '"';
    }

    public function getDirty( $article, $popts ) {
        $value = $this->get( $article, $popts, true );
        return is_object( $value ) ? $value : false;
    }

    public function getKey( $article, $popts, $useOutdated = true ) {
        global $wgCacheEpoch;

        if ( $popts instanceof User ) {
            wfWarn( "Use of outdated prototype ParserCache::getKey( &\$article, &\$user )\n" );
            $popts = ParserOptions::newFromUser( $popts );
        }

        // Determine the options which affect this article
        $casToken = null;
        $optionsKey = $this->mMemc->get(
            $this->getOptionsKey( $article ), $casToken, BagOStuff::READ_VERIFIED );
        if ( $optionsKey instanceof CacheTime ) {
            if ( !$useOutdated && $optionsKey->expired( $article->getTouched() ) ) {
                wfIncrStats( "pcache.miss.expired" );
                $cacheTime = $optionsKey->getCacheTime();
                wfDebugLog( "ParserCache",
                    "Parser options key expired, touched " . $article->getTouched()
                    . ", epoch $wgCacheEpoch, cached $cacheTime\n" );
                return false;
            } elseif ( !$useOutdated && $optionsKey->isDifferentRevision( $article->getLatest() ) ) {
                wfIncrStats( "pcache.miss.revid" );
                $revId = $article->getLatest();
                $cachedRevId = $optionsKey->getCacheRevisionId();
                wfDebugLog( "ParserCache",
                    "ParserOutput key is for an old revision, latest $revId, cached $cachedRevId\n"
                );
                return false;
            }

            // $optionsKey->mUsedOptions is set by save() by calling ParserOutput::getUsedOptions()
            $usedOptions = $optionsKey->mUsedOptions;
            wfDebug( "Parser cache options found.\n" );
        } else {
            if ( !$useOutdated ) {
                return false;
            }
            $usedOptions = ParserOptions::legacyOptions();
        }

        return $this->getParserOutputKey(
            $article,
            $popts->optionsHash( $usedOptions, $article->getTitle() )
        );
    }

    public function get( $article, $popts, $useOutdated = false ) {
        global $wgCacheEpoch;

        $canCache = $article->checkTouched();
        if ( !$canCache ) {
            // It's a redirect now
            return false;
        }

        $touched = $article->getTouched();

        $parserOutputKey = $this->getKey( $article, $popts, $useOutdated );
        if ( $parserOutputKey === false ) {
            wfIncrStats( 'pcache.miss.absent' );
            return false;
        }

        $casToken = null;
        $value = $this->mMemc->get( $parserOutputKey, $casToken, BagOStuff::READ_VERIFIED );
        if ( !$value ) {
            wfDebug( "ParserOutput cache miss.\n" );
            wfIncrStats( "pcache.miss.absent" );
            return false;
        }

        wfDebug( "ParserOutput cache found.\n" );

        // The edit section preference may not be the appropiate one in
        // the ParserOutput, as we are not storing it in the parsercache
        // key. Force it here. See bug 31445.
        $value->setEditSectionTokens( $popts->getEditSection() );

        $wikiPage = method_exists( $article, 'getPage' )
            ? $article->getPage()
            : $article;

        if ( !$useOutdated && $value->expired( $touched ) ) {
            wfIncrStats( "pcache.miss.expired" );
            $cacheTime = $value->getCacheTime();
            wfDebugLog( "ParserCache",
                "ParserOutput key expired, touched $touched, "
                . "epoch $wgCacheEpoch, cached $cacheTime\n" );
            $value = false;
        } elseif ( !$useOutdated && $value->isDifferentRevision( $article->getLatest() ) ) {
            wfIncrStats( "pcache.miss.revid" );
            $revId = $article->getLatest();
            $cachedRevId = $value->getCacheRevisionId();
            wfDebugLog( "ParserCache",
                "ParserOutput key is for an old revision, latest $revId, cached $cachedRevId\n"
            );
            $value = false;
        } elseif (
            Hooks::run( 'RejectParserCacheValue', [ $value, $wikiPage, $popts ] ) === false
        ) {
            wfIncrStats( 'pcache.miss.rejected' );
            wfDebugLog( "ParserCache",
                "ParserOutput key valid, but rejected by RejectParserCacheValue hook handler.\n"
            );
            $value = false;
        } else {
            wfIncrStats( "pcache.hit" );
        }

        return $value;
    }

    public function save( $parserOutput, $page, $popts, $cacheTime = null, $revId = null ) {
        $expire = $parserOutput->getCacheExpiry();
        if ( $expire > 0 && !$this->mMemc instanceof EmptyBagOStuff ) {
            $cacheTime = $cacheTime ?: wfTimestampNow();
            if ( !$revId ) {
                $revision = $page->getRevision();
                $revId = $revision ? $revision->getId() : null;
            }

            $optionsKey = new CacheTime;
            $optionsKey->mUsedOptions = $parserOutput->getUsedOptions();
            $optionsKey->updateCacheExpiry( $expire );

            $optionsKey->setCacheTime( $cacheTime );
            $parserOutput->setCacheTime( $cacheTime );
            $optionsKey->setCacheRevisionId( $revId );
            $parserOutput->setCacheRevisionId( $revId );

            $parserOutputKey = $this->getParserOutputKey( $page,
                $popts->optionsHash( $optionsKey->mUsedOptions, $page->getTitle() ) );

            // Save the timestamp so that we don't have to load the revision row on view
            $parserOutput->setTimestamp( $page->getTimestamp() );

            $msg = "Saved in parser cache with key $parserOutputKey" .
                " and timestamp $cacheTime" .
                " and revision id $revId" .
                "\n";

            $parserOutput->mText .= "\n<!-- $msg -->\n";
            wfDebug( $msg );

            // Save the parser output
            $this->mMemc->set( $parserOutputKey, $parserOutput, $expire );

            // ...and its pointer
            $this->mMemc->set( $this->getOptionsKey( $page ), $optionsKey, $expire );

            Hooks::run(
                'ParserCacheSaveComplete',
                [ $this, $parserOutput, $page->getTitle(), $popts, $revId ]
            );
        } elseif ( $expire <= 0 ) {
            wfDebug( "Parser output was marked as uncacheable and has not been saved.\n" );
        }
    }
}