ParsoidFormatHelper.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Rest\Handler;
 
use InvalidArgumentException;
use MediaWiki\Rest\ResponseInterface;
 
class ParsoidFormatHelper {
 
    public const FORMAT_WIKITEXT = 'wikitext';
    public const FORMAT_HTML = 'html';
    public const FORMAT_PAGEBUNDLE = 'pagebundle';
    public const FORMAT_LINT = 'lint';
 
    public const ERROR_ENCODING = [
        self::FORMAT_WIKITEXT => 'plain',
        self::FORMAT_HTML => 'html',
        self::FORMAT_PAGEBUNDLE => 'json',
        self::FORMAT_LINT => 'json',
    ];
 
    public const VALID_PAGE = [
        self::FORMAT_WIKITEXT, self::FORMAT_HTML, self::FORMAT_PAGEBUNDLE, self::FORMAT_LINT
    ];
 
    public const VALID_TRANSFORM = [
        self::FORMAT_WIKITEXT => [ self::FORMAT_HTML, self::FORMAT_PAGEBUNDLE, self::FORMAT_LINT ],
        self::FORMAT_HTML => [ self::FORMAT_WIKITEXT ],
        self::FORMAT_PAGEBUNDLE => [ self::FORMAT_WIKITEXT, self::FORMAT_PAGEBUNDLE ],
    ];
 
    public static function getContentType(
        string $format, ?string $contentVersion = null
    ): string {
        if ( $format !== self::FORMAT_WIKITEXT && !$contentVersion ) {
            throw new InvalidArgumentException( '$contentVersion is required for this format' );
        }
 
        switch ( $format ) {
            case self::FORMAT_WIKITEXT:
                $contentType = 'text/plain';
                // PORT-FIXME in the original the version number is from MWParserEnvironment.wikitextVersion
                // but it did not seem to be used anywhere
                $profile = 'https://www.mediawiki.org/wiki/Specs/wikitext/1.0.0';
                break;
            case self::FORMAT_HTML:
                $contentType = 'text/html';
                $profile = 'https://www.mediawiki.org/wiki/Specs/HTML/' . $contentVersion;
                break;
            case self::FORMAT_PAGEBUNDLE:
                $contentType = 'application/json';
                $profile = 'https://www.mediawiki.org/wiki/Specs/pagebundle/' . $contentVersion;
                break;
            default:
                throw new InvalidArgumentException( "Invalid format $format" );
        }
        return "$contentType; charset=utf-8; profile=\"$profile\"";
    }
 
    public static function setContentType(
        ResponseInterface $response, string $format,
        ?string $contentVersion = null
    ): void {
        $response->setHeader( 'Content-Type', self::getContentType( $format, $contentVersion ) );
    }
 
    public static function parseContentTypeHeader(
        string $contentTypeHeader, ?string &$format = null
    ): ?string {
        $newProfileSyntax = 'https://www.mediawiki.org/wiki/Specs/(HTML|pagebundle)/';
        $oldProfileSyntax = 'mediawiki.org/specs/(html)/';
        $profileRegex = "#\bprofile=\"(?:$newProfileSyntax|$oldProfileSyntax)(\d+\.\d+\.\d+)\"#";
        preg_match( $profileRegex, $contentTypeHeader, $m );
        if ( $m ) {
            switch ( $m[1] ?: $m[2] ) {
                case 'HTML':
                case 'html':
                    $format = self::FORMAT_HTML;
                    break;
                case 'pagebundle':
                    $format = self::FORMAT_PAGEBUNDLE;
                    break;
            }
            return $m[3];
        }
        return null;
    }
 
}