ApiFormatJson.php

Go to the documentation of this file.

<?php
use MediaWiki\Json\FormatJson;
use Wikimedia\ParamValidator\ParamValidator;
 
class ApiFormatJson extends ApiFormatBase {
 
    private $isRaw;
 
    public function __construct( ApiMain $main, $format ) {
        parent::__construct( $main, $format );
        $this->isRaw = ( $format === 'rawfm' );
 
        if ( $this->getMain()->getCheck( 'callback' ) ) {
            # T94015: jQuery appends a useless '_' parameter in jsonp mode.
            # Mark the parameter as used in that case to avoid a warning that's
            # outside the control of the end user.
            # (and do it here because ApiMain::reportUnusedParams() gets called
            # before our ::execute())
            $this->getMain()->markParamsUsed( '_' );
        }
    }
 
    public function getMimeType() {
        $params = $this->extractRequestParams();
        // callback:
        if ( isset( $params['callback'] ) ) {
            return 'text/javascript';
        }
 
        return 'application/json';
    }
 
    public function execute() {
        $params = $this->extractRequestParams();
 
        $opt = 0;
        if ( $this->isRaw ) {
            $opt |= FormatJson::ALL_OK;
            $transform = [];
        } else {
            switch ( $params['formatversion'] ) {
                case 1:
                    $opt |= $params['utf8'] ? FormatJson::ALL_OK : FormatJson::XMLMETA_OK;
                    $transform = [
                        'BC' => [],
                        'Types' => [ 'AssocAsObject' => true ],
                        'Strip' => 'all',
                    ];
                    break;
 
                case 2:
                case 'latest':
                    $opt |= $params['ascii'] ? FormatJson::XMLMETA_OK : FormatJson::ALL_OK;
                    $transform = [
                        'Types' => [ 'AssocAsObject' => true ],
                        'Strip' => 'all',
                    ];
                    break;
 
                default:
                    // Should have been caught during parameter validation
                    // @codeCoverageIgnoreStart
                    self::dieDebug( __METHOD__, 'Unknown value for \'formatversion\'' );
                    // @codeCoverageIgnoreEnd
            }
        }
        $data = $this->getResult()->getResultData( null, $transform );
        $json = FormatJson::encode( $data, $this->getIsHtml(), $opt );
        if ( $json === false ) {
            // This should never happen, but it's a bug which could crop up
            // if you use ApiResult::NO_VALIDATE for instance.
            // @codeCoverageIgnoreStart
            self::dieDebug( __METHOD__, 'Unable to encode API result as JSON' );
            // @codeCoverageIgnoreEnd
        }
 
        if ( isset( $params['callback'] ) ) {
            $callback = preg_replace( "/[^][.\\'\\\"_A-Za-z0-9]/", '', $params['callback'] );
            # Prepend a comment to try to avoid attacks against content
            # sniffers, such as T70187.
            $this->printText( "/**/$callback($json)" );
        } else {
            $this->printText( $json );
        }
    }
 
    public function getAllowedParams() {
        if ( $this->isRaw ) {
            return parent::getAllowedParams();
        }
 
        return parent::getAllowedParams() + [
            'callback' => [
                ApiBase::PARAM_HELP_MSG => 'apihelp-json-param-callback',
            ],
            'utf8' => [
                ParamValidator::PARAM_DEFAULT => false,
                ApiBase::PARAM_HELP_MSG => 'apihelp-json-param-utf8',
            ],
            'ascii' => [
                ParamValidator::PARAM_DEFAULT => false,
                ApiBase::PARAM_HELP_MSG => 'apihelp-json-param-ascii',
            ],
            'formatversion' => [
                ParamValidator::PARAM_TYPE => [ '1', '2', 'latest' ],
                ParamValidator::PARAM_DEFAULT => '1',
                ApiBase::PARAM_HELP_MSG => 'apihelp-json-param-formatversion',
                ApiBase::PARAM_HELP_MSG_PER_VALUE => [
                    '1' => 'apihelp-json-paramvalue-formatversion-1',
                    '2' => 'apihelp-json-paramvalue-formatversion-2',
                    'latest' => 'apihelp-json-paramvalue-formatversion-latest',
                ],
            ],
        ];
    }
}