ApiFormatXml.php

Go to the documentation of this file.

<?php
use MediaWiki\Title\Title;
use MediaWiki\Xml\Xml;
use Wikimedia\ParamValidator\ParamValidator;
 
class ApiFormatXml extends ApiFormatBase {
 
    private $mRootElemName = 'api';
    public static $namespace = 'http://www.mediawiki.org/xml/api/';
    private $mIncludeNamespace = false;
    private $mXslt = null;
 
    public function getMimeType() {
        return 'text/xml';
    }
 
    public function setRootElement( $rootElemName ) {
        $this->mRootElemName = $rootElemName;
    }
 
    public function execute() {
        $params = $this->extractRequestParams();
        $this->mIncludeNamespace = $params['includexmlnamespace'];
        $this->mXslt = $params['xslt'];
 
        $this->printText( '<?xml version="1.0"?>' );
        if ( $this->mXslt !== null ) {
            $this->addXslt();
        }
 
        $result = $this->getResult();
        if ( $this->mIncludeNamespace && $result->getResultData( 'xmlns' ) === null ) {
            // If the result data already contains an 'xmlns' namespace added
            // for custom XML output types, it will override the one for the
            // generic API results.
            // This allows API output of other XML types like Atom, RSS, RSD.
            $result->addValue( null, 'xmlns', self::$namespace, ApiResult::NO_SIZE_CHECK );
        }
        $data = $result->getResultData( null, [
            'Custom' => static function ( &$data, &$metadata ) {
                if ( isset( $metadata[ApiResult::META_TYPE] ) ) {
                    // We want to use non-BC for BCassoc to force outputting of _idx.
                    switch ( $metadata[ApiResult::META_TYPE] ) {
                        case 'BCassoc':
                            $metadata[ApiResult::META_TYPE] = 'assoc';
                            break;
                    }
                }
            },
            'BC' => [ 'nobool', 'no*', 'nosub' ],
            'Types' => [ 'ArmorKVP' => '_name' ],
        ] );
 
        $this->printText(
            static::recXmlPrint( $this->mRootElemName,
                $data,
                $this->getIsHtml() ? -2 : null
            )
        );
    }
 
    public static function recXmlPrint( $name, $value, $indent, $attributes = [] ) {
        $retval = '';
        if ( $indent !== null ) {
            if ( $name !== null ) {
                $indent += 2;
            }
            $indstr = "\n" . str_repeat( ' ', $indent );
        } else {
            $indstr = '';
        }
 
        if ( is_object( $value ) ) {
            $value = (array)$value;
        }
        if ( is_array( $value ) ) {
            $contentKey = $value[ApiResult::META_CONTENT] ?? '*';
            $subelementKeys = $value[ApiResult::META_SUBELEMENTS] ?? [];
            if ( isset( $value[ApiResult::META_BC_SUBELEMENTS] ) ) {
                $subelementKeys = array_merge(
                    $subelementKeys, $value[ApiResult::META_BC_SUBELEMENTS]
                );
            }
            $preserveKeys = $value[ApiResult::META_PRESERVE_KEYS] ?? [];
            $indexedTagName = isset( $value[ApiResult::META_INDEXED_TAG_NAME] )
                ? self::mangleName( $value[ApiResult::META_INDEXED_TAG_NAME], $preserveKeys )
                : '_v';
            $bcBools = $value[ApiResult::META_BC_BOOLS] ?? [];
            $indexSubelements = isset( $value[ApiResult::META_TYPE] )
                && $value[ApiResult::META_TYPE] !== 'array';
 
            $content = null;
            $subelements = [];
            $indexedSubelements = [];
            foreach ( $value as $k => $v ) {
                if ( ApiResult::isMetadataKey( $k ) && !in_array( $k, $preserveKeys, true ) ) {
                    continue;
                }
 
                $oldv = $v;
                if ( is_bool( $v ) && !in_array( $k, $bcBools, true ) ) {
                    $v = $v ? 'true' : 'false';
                }
 
                if ( $name !== null && $k === $contentKey ) {
                    $content = $v;
                } elseif ( is_int( $k ) ) {
                    $indexedSubelements[$k] = $v;
                } elseif ( is_array( $v ) || is_object( $v ) ) {
                    $subelements[self::mangleName( $k, $preserveKeys )] = $v;
                } elseif ( in_array( $k, $subelementKeys, true ) || $name === null ) {
                    $subelements[self::mangleName( $k, $preserveKeys )] = [
                        'content' => $v,
                        ApiResult::META_CONTENT => 'content',
                        ApiResult::META_TYPE => 'assoc',
                    ];
                } elseif ( is_bool( $oldv ) ) {
                    if ( $oldv ) {
                        $attributes[self::mangleName( $k, $preserveKeys )] = '';
                    }
                } elseif ( $v !== null ) {
                    $attributes[self::mangleName( $k, $preserveKeys )] = $v;
                }
            }
 
            if ( $content !== null ) {
                if ( $subelements || $indexedSubelements ) {
                    $subelements[self::mangleName( $contentKey, $preserveKeys )] = [
                        'content' => $content,
                        ApiResult::META_CONTENT => 'content',
                        ApiResult::META_TYPE => 'assoc',
                    ];
                    $content = null;
                } elseif ( is_scalar( $content ) ) {
                    // Add xml:space="preserve" to the element so XML parsers
                    // will leave whitespace in the content alone
                    $attributes += [ 'xml:space' => 'preserve' ];
                }
            }
 
            if ( $content !== null ) {
                if ( is_scalar( $content ) ) {
                    // @phan-suppress-next-line PhanTypeMismatchArgumentNullable name is check for null in other code
                    $retval .= $indstr . Xml::element( $name, $attributes, $content );
                } else {
                    if ( $name !== null ) {
                        $retval .= $indstr . Xml::element( $name, $attributes, null );
                    }
                    $retval .= static::recXmlPrint( null, $content, $indent );
                    if ( $name !== null ) {
                        $retval .= $indstr . Xml::closeElement( $name );
                    }
                }
            } elseif ( !$indexedSubelements && !$subelements ) {
                if ( $name !== null ) {
                    $retval .= $indstr . Xml::element( $name, $attributes );
                }
            } else {
                if ( $name !== null ) {
                    $retval .= $indstr . Xml::element( $name, $attributes, null );
                }
                foreach ( $subelements as $k => $v ) {
                    $retval .= static::recXmlPrint( $k, $v, $indent );
                }
                foreach ( $indexedSubelements as $k => $v ) {
                    $retval .= static::recXmlPrint( $indexedTagName, $v, $indent,
                        $indexSubelements ? [ '_idx' => $k ] : []
                    );
                }
                if ( $name !== null ) {
                    $retval .= $indstr . Xml::closeElement( $name );
                }
            }
        } else {
            // to make sure null value doesn't produce unclosed element,
            // which is what Xml::element( $name, null, null ) returns
            if ( $value === null ) {
                // @phan-suppress-next-line PhanTypeMismatchArgumentNullable name is check for null in other code
                $retval .= $indstr . Xml::element( $name, $attributes );
            } else {
                // @phan-suppress-next-line PhanTypeMismatchArgumentNullable name is check for null in other code
                $retval .= $indstr . Xml::element( $name, $attributes, $value );
            }
        }
 
        return $retval;
    }
 
    private static function mangleName( $name, $preserveKeys = [] ) {
        static $nsc = null, $nc = null;
 
        if ( in_array( $name, $preserveKeys, true ) ) {
            return $name;
        }
 
        if ( $name === '' ) {
            return '_';
        }
 
        if ( $nsc === null ) {
            // Note we omit ':' from $nsc and $nc because it's reserved for XML
            // namespacing, and we omit '_' from $nsc (but not $nc) because we
            // reserve it.
            $nsc = 'A-Za-z\x{C0}-\x{D6}\x{D8}-\x{F6}\x{F8}-\x{2FF}\x{370}-\x{37D}\x{37F}-\x{1FFF}' .
                '\x{200C}-\x{200D}\x{2070}-\x{218F}\x{2C00}-\x{2FEF}\x{3001}-\x{D7FF}' .
                '\x{F900}-\x{FDCF}\x{FDF0}-\x{FFFD}\x{10000}-\x{EFFFF}';
            $nc = $nsc . '_\-.0-9\x{B7}\x{300}-\x{36F}\x{203F}-\x{2040}';
        }
 
        if ( preg_match( "/^[$nsc][$nc]*$/uS", $name ) ) {
            return $name;
        }
 
        return '_' . preg_replace_callback(
            "/[^$nc]/uS",
            static function ( $m ) {
                return sprintf( '.%X.', UtfNormal\Utils::utf8ToCodepoint( $m[0] ) );
            },
            str_replace( '.', '.2E.', $name )
        );
    }
 
    protected function addXslt() {
        $nt = Title::newFromText( $this->mXslt );
        if ( $nt === null || !$nt->exists() ) {
            $this->addWarning( 'apiwarn-invalidxmlstylesheet' );
 
            return;
        }
        if ( $nt->getNamespace() !== NS_MEDIAWIKI ) {
            $this->addWarning( 'apiwarn-invalidxmlstylesheetns' );
 
            return;
        }
        if ( !str_ends_with( $nt->getText(), '.xsl' ) ) {
            $this->addWarning( 'apiwarn-invalidxmlstylesheetext' );
 
            return;
        }
        $this->printText( '<?xml-stylesheet href="' .
            htmlspecialchars( $nt->getLocalURL( 'action=raw' ) ) . '" type="text/xsl" ?>' );
    }
 
    public function getAllowedParams() {
        return parent::getAllowedParams() + [
            'xslt' => [
                ApiBase::PARAM_HELP_MSG => 'apihelp-xml-param-xslt',
            ],
            'includexmlnamespace' => [
                ParamValidator::PARAM_DEFAULT => false,
                ApiBase::PARAM_HELP_MSG => 'apihelp-xml-param-includexmlnamespace',
            ],
        ];
    }
}