CoreMagicVariables.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Parser;
 
use MediaWiki\Config\ServiceOptions;
use MediaWiki\Language\Language;
use MediaWiki\MainConfigNames;
use MediaWiki\Specials\SpecialVersion;
use MediaWiki\Utils\MWTimestamp;
use Psr\Log\LoggerInterface;
use Wikimedia\Timestamp\ConvertibleTimestamp;
use Wikimedia\Timestamp\TimestampFormat as TS;
 
class CoreMagicVariables {
    private const CACHE_TTL_BY_ID = [
        'currenttime' => 3600,
        'localtime' => 3600,
        'numberofarticles' => 3600,
        'numberoffiles' => 3600,
        'numberofedits' => 3600,
        'numberofusers' => 3600,
        'numberofactiveusers' => 3600,
        'numberofpages' => 3600,
        'currentversion' => 86400,
        'currenttimestamp' => 3600,
        'localtimestamp' => 3600,
        'pagesinnamespace' => 3600,
        'numberofadmins' => 3600,
        'numberingroup' => 3600,
    ];
 
    private const DEADLINE_TTL_CLOCK_FUDGE = 1;
 
    private const DEADLINE_TTL_STAGGER_MAX = 15;
 
    private const MIN_DEADLINE_TTL = 30 * 60;
 
    public static function expand(
        // Fundamental options
        Parser $parser,
        string $id,
        // Context passed over from the parser
        ConvertibleTimestamp $ts,
        ServiceOptions $svcOptions,
        LoggerInterface $logger,
        $frame = false
    ): ?string {
        $pageLang = $parser->getTargetLanguage();
 
        $title = $frame ? $frame->getTitle() : $parser->getTitle();
        $source = $title->getPrefixedDBkey() . " ($id)";
 
        $cacheTTL = self::CACHE_TTL_BY_ID[$id] ?? -1;
        if ( $cacheTTL > -1 ) {
            $parser->getOutput()->updateCacheExpiry( $cacheTTL, $source );
        }
 
        switch ( $id ) {
            case '!':
                return '|';
            case '=':
                return '=';
            case 'currentmonth':
                self::applyUnitTimestampDeadline( $parser, $ts, 'M', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'm' ) );
            case 'currentmonth1':
                self::applyUnitTimestampDeadline( $parser, $ts, 'M', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'n' ) );
            case 'currentmonthname':
                self::applyUnitTimestampDeadline( $parser, $ts, 'M', $source );
 
                return $pageLang->getMonthName( (int)$ts->format( 'n' ) );
            case 'currentmonthnamegen':
                self::applyUnitTimestampDeadline( $parser, $ts, 'M', $source );
 
                return $pageLang->getMonthNameGen( (int)$ts->format( 'n' ) );
            case 'currentmonthabbrev':
                self::applyUnitTimestampDeadline( $parser, $ts, 'M', $source );
 
                return $pageLang->getMonthAbbreviation( (int)$ts->format( 'n' ) );
            case 'currentday':
                self::applyUnitTimestampDeadline( $parser, $ts, 'D', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'j' ) );
            case 'currentday2':
                self::applyUnitTimestampDeadline( $parser, $ts, 'D', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'd' ) );
            case 'localmonth':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'M', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'm' ) );
            case 'localmonth1':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'M', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'n' ) );
            case 'localmonthname':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'M', $source );
 
                return $pageLang->getMonthName( (int)$localTs->format( 'n' ) );
            case 'localmonthnamegen':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'M', $source );
 
                return $pageLang->getMonthNameGen( (int)$localTs->format( 'n' ) );
            case 'localmonthabbrev':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'M', $source );
 
                return $pageLang->getMonthAbbreviation( (int)$localTs->format( 'n' ) );
            case 'localday':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'D', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'j' ) );
            case 'localday2':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'D', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'd' ) );
            case 'pagename':
            case 'pagenamee':
            case 'fullpagename':
            case 'fullpagenamee':
            case 'subpagename':
            case 'subpagenamee':
            case 'rootpagename':
            case 'rootpagenamee':
            case 'basepagename':
            case 'basepagenamee':
            case 'talkpagename':
            case 'talkpagenamee':
            case 'subjectpagename':
            case 'subjectpagenamee':
            case 'pageid':
            case 'revisionid':
            case 'revisionuser':
            case 'revisionday':
            case 'revisionday2':
            case 'revisionmonth':
            case 'revisionmonth1':
            case 'revisionyear':
            case 'revisiontimestamp':
            case 'namespace':
            case 'namespacee':
            case 'namespacenumber':
            case 'talkspace':
            case 'talkspacee':
            case 'subjectspace':
            case 'subjectspacee':
            case 'cascadingsources':
                # First argument of the corresponding parser function
                # (second argument of the PHP implementation) is
                # "title".
 
                # Note that for many of these {{FOO}} is subtly different
                # from {{FOO:{{PAGENAME}}}}, so we can't pass $title here
                # we have to explicitly use the "no arguments" form of the
                # parser function by passing `null` to indicate a missing
                # argument (which then defaults to the current page title).
                return CoreParserFunctions::$id( $parser, null );
            case 'revisionsize':
                return (string)$parser->getRevisionSize();
            case 'currentdayname':
                self::applyUnitTimestampDeadline( $parser, $ts, 'D', $source );
 
                return $pageLang->getWeekdayName( (int)$ts->format( 'w' ) + 1 );
            case 'currentyear':
                self::applyUnitTimestampDeadline( $parser, $ts, 'Y', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'Y' ) );
            case 'currenttime':
                return $pageLang->time( $ts->getTimestamp( TS::MW ), false, false );
            case 'currenthour':
                self::applyUnitTimestampDeadline( $parser, $ts, 'H', $source );
 
                return $pageLang->formatNumNoSeparators( $ts->format( 'H' ) );
            case 'currentweek':
                self::applyUnitTimestampDeadline( $parser, $ts, 'D', $source );
                // @bug T6594 PHP5 has it zero padded, PHP4 does not, cast to
                // int to remove the padding
                return $pageLang->formatNum( (int)$ts->format( 'W' ) );
            case 'currentdow':
                self::applyUnitTimestampDeadline( $parser, $ts, 'D', $source );
 
                return $pageLang->formatNum( $ts->format( 'w' ) );
            case 'localdayname':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'D', $source );
 
                return $pageLang->getWeekdayName( (int)$localTs->format( 'w' ) + 1 );
            case 'localyear':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'Y', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'Y' ) );
            case 'localtime':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
 
                return $pageLang->time(
                    $localTs->format( 'YmdHis' ),
                    false,
                    false
                );
            case 'localhour':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'H', $source );
 
                return $pageLang->formatNumNoSeparators( $localTs->format( 'H' ) );
            case 'localweek':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'D', $source );
                // @bug T6594 PHP5 has it zero padded, PHP4 does not, cast to
                // int to remove the padding
                return $pageLang->formatNum( (int)$localTs->format( 'W' ) );
            case 'localdow':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
                self::applyUnitTimestampDeadline( $parser, $localTs, 'D', $source );
 
                return $pageLang->formatNum( $localTs->format( 'w' ) );
            case 'numberofarticles':
            case 'numberoffiles':
            case 'numberofusers':
            case 'numberofactiveusers':
            case 'numberofpages':
            case 'numberofadmins':
            case 'numberofedits':
                # second argument is 'raw'; magic variables are "not raw"
                return CoreParserFunctions::$id( $parser, null );
            case 'currenttimestamp':
                return $ts->getTimestamp( TS::MW );
            case 'localtimestamp':
                $localTs = self::makeTsLocal( $svcOptions, $ts );
 
                return $localTs->format( 'YmdHis' );
            case 'currentversion':
                return SpecialVersion::getVersion();
            case 'articlepath':
                return (string)$svcOptions->get( MainConfigNames::ArticlePath );
            case 'sitename':
                return (string)$svcOptions->get( MainConfigNames::Sitename );
            case 'server':
                return (string)$svcOptions->get( MainConfigNames::Server );
            case 'servername':
                return (string)$svcOptions->get( MainConfigNames::ServerName );
            case 'scriptpath':
                return (string)$svcOptions->get( MainConfigNames::ScriptPath );
            case 'stylepath':
                return (string)$svcOptions->get( MainConfigNames::StylePath );
            case 'directionmark':
                return $pageLang->getDirMark();
            case 'contentlanguage':
                return $parser->getContentLanguage()->getCode();
            case 'pagelanguage':
                return $pageLang->getCode();
            case 'userlanguage':
                if ( $parser->getOptions()->isMessage()
                    || $svcOptions->get( MainConfigNames::ParserEnableUserLanguage )
                ) {
                    return $parser->getOptions()->getUserLang();
                } else {
                    return $pageLang->getCode();
                }
            case 'bcp47':
            case 'contentmodel':
            case 'dir':
            case 'language':
                # magic variables are the same as empty/default first argument
                return CoreParserFunctions::$id( $parser );
            default:
                // This is not one of the core magic variables
                return null;
        }
    }
 
    private static function makeTsLocal( $svcOptions, $ts ) {
        $localtimezone = $svcOptions->get( MainConfigNames::Localtimezone );
        $ts->setTimezone( $localtimezone );
        return $ts;
    }
 
    public static function applyUnitTimestampDeadline(
        Parser $parser,
        ?ConvertibleTimestamp $ts,
        string $unit,
        ?string $source = null
    ): void {
        $date = $ts?->timestamp ?? $parser->getParseTime();
        $ttl = Language::computeUnitTimestampDeadline( $date, $unit );
        self::applyCacheExpiry( $parser, $ttl, $date->getTimestamp(), $source );
    }
 
    public static function applyCacheExpiry(
        Parser $parser,
        int $ttl,
        ?int $stagger = null,
        ?string $source = null
    ): void {
        $stagger ??= abs( $ttl ) ?: time();
        $ttl = max( $ttl, self::MIN_DEADLINE_TTL );
        $ttl += self::DEADLINE_TTL_CLOCK_FUDGE;
        $ttl += ( $stagger % self::DEADLINE_TTL_STAGGER_MAX );
        $parser->getOutput()->updateCacheExpiry( $ttl, $source );
    }
}
 
class_alias( CoreMagicVariables::class, 'CoreMagicVariables' );