CacheTime.php

Go to the documentation of this file.

<?php
class CacheTime {
    public $mUsedOptions;

    # Compatibility check
    public $mVersion = Parser::VERSION;

    # Time when this object was generated, or -1 for uncacheable. Used in ParserCache.
    public $mCacheTime = '';

    # Seconds after which the object should expire, use 0 for uncacheable. Used in ParserCache.
    public $mCacheExpiry = null;

    # Revision ID that was parsed
    public $mCacheRevisionId = null;

    public function getCacheTime() {
        return wfTimestamp( TS_MW, $this->mCacheTime );
    }

    public function setCacheTime( $t ) {
        return wfSetVar( $this->mCacheTime, $t );
    }

    public function getCacheRevisionId() {
        return $this->mCacheRevisionId;
    }

    public function setCacheRevisionId( $id ) {
        $this->mCacheRevisionId = $id;
    }

    public function updateCacheExpiry( $seconds ) {
        $seconds = (int)$seconds;

        if ( $this->mCacheExpiry === null || $this->mCacheExpiry > $seconds ) {
            $this->mCacheExpiry = $seconds;
        }
    }

    public function getCacheExpiry() {
        global $wgParserCacheExpireTime;

        if ( $this->mCacheTime < 0 ) {
            return 0;
        } // old-style marker for "not cacheable"

        $expire = $this->mCacheExpiry;

        if ( $expire === null ) {
            $expire = $wgParserCacheExpireTime;
        } else {
            $expire = min( $expire, $wgParserCacheExpireTime );
        }

        if ( $expire <= 0 ) {
            return 0; // not cacheable
        } else {
            return $expire;
        }
    }

    public function isCacheable() {
        return $this->getCacheExpiry() > 0;
    }

    public function expired( $touched ) {
        global $wgCacheEpoch;

        return !$this->isCacheable() // parser says it's uncacheable
            || $this->getCacheTime() < $touched
            || $this->getCacheTime() <= $wgCacheEpoch
            || $this->getCacheTime() <
                wfTimestamp( TS_MW, time() - $this->getCacheExpiry() ) // expiry period has passed
            || !isset( $this->mVersion )
            || version_compare( $this->mVersion, Parser::VERSION, "lt" );
    }

    public function isDifferentRevision( $id ) {
        $cached = $this->getCacheRevisionId();
        return $cached !== null && $id !== $cached;
    }
}