ApiCategoryTree.php

Go to the documentation of this file.

<?php
 
use MediaWiki\MediaWikiServices;
 
class ApiCategoryTree extends ApiBase {
    public function execute() {
        $params = $this->extractRequestParams();
        $options = [];
        if ( isset( $params['options'] ) ) {
            $options = FormatJson::decode( $params['options'] );
            if ( !is_object( $options ) ) {
                $this->dieWithError( 'apierror-categorytree-invalidjson', 'invalidjson' );
            }
            $options = get_object_vars( $options );
        }
 
        $title = CategoryTree::makeTitle( $params['category'] );
        if ( !$title || $title->isExternal() ) {
            $this->dieWithError( [ 'apierror-invalidtitle', wfEscapeWikiText( $params['category'] ) ] );
        }
 
        $depth = isset( $options['depth'] ) ? (int)$options['depth'] : 1;
 
        $ct = new CategoryTree( $options );
        $depth = CategoryTree::capDepth( $ct->getOption( 'mode' ), $depth );
        $ctConfig = MediaWikiServices::getInstance()->getConfigFactory()->makeConfig( 'categorytree' );
        $html = $this->getHTML( $ct, $title, $depth, $ctConfig );
 
        $this->getMain()->setCacheMode( 'public' );
 
        $this->getResult()->addContentValue( $this->getModuleName(), 'html', $html );
    }
 
    public function getConditionalRequestData( $condition ) {
        if ( $condition === 'last-modified' ) {
            $params = $this->extractRequestParams();
            $title = CategoryTree::makeTitle( $params['category'] );
            return wfGetDB( DB_REPLICA )->selectField( 'page', 'page_touched',
                [
                    'page_namespace' => NS_CATEGORY,
                    'page_title' => $title->getDBkey(),
                ],
                __METHOD__
            );
        }
    }
 
    private function getHTML( CategoryTree $ct, Title $title, $depth, Config $ctConfig ) {
        global $wgMemc;
 
        $mckey = ObjectCache::getLocalClusterInstance()->makeKey(
            'ajax-categorytree',
            md5( $title->getDBkey() ),
            md5( $ct->getOptionsAsCacheKey( $depth ) ),
            $this->getLanguage()->getCode(),
            MediaWikiServices::getInstance()->getContentLanguage()->getExtraHashOptions(),
            $ctConfig->get( 'RenderHashAppend' )
        );
 
        $touched = $this->getConditionalRequestData( 'last-modified' );
        if ( $touched ) {
            $mcvalue = $wgMemc->get( $mckey );
            if ( $mcvalue && $touched <= $mcvalue['timestamp'] ) {
                $html = $mcvalue['value'];
            }
        }
 
        if ( !isset( $html ) ) {
            $html = $ct->renderChildren( $title, $depth );
 
            $wgMemc->set(
                $mckey,
                [
                    'timestamp' => wfTimestampNow(),
                    'value' => $html
                ],
                86400
            );
        }
        return trim( $html );
    }
 
    public function getAllowedParams() {
        return [
            'category' => [
                ApiBase::PARAM_TYPE => 'string',
                ApiBase::PARAM_REQUIRED => true,
            ],
            'options' => [
                ApiBase::PARAM_TYPE => 'string',
            ],
        ];
    }
 
    public function isInternal() {
        return true;
    }
}