PageDataRequestHandler.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use MediaWiki\Output\OutputPage;
use MediaWiki\Request\WebRequest;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Title\MalformedTitleException;
use MediaWiki\Title\Title;
use Wikimedia\Http\HttpAcceptNegotiator;
use Wikimedia\Http\HttpAcceptParser;
 
class PageDataRequestHandler {
 
    public function canHandleRequest( $subPage, WebRequest $request ) {
        if ( $subPage === '' || $subPage === null ) {
            return $request->getText( 'target' ) !== '';
        }
 
        $parts = explode( '/', $subPage, 2 );
        $slot = $parts[0];
        $title = $parts[1] ?? '';
        return ( $slot === SlotRecord::MAIN || $slot === '' ) && $title !== '';
    }
 
    public function handleRequest( $subPage, WebRequest $request, OutputPage $output ) {
        // No matter what: The response is always public
        $output->getRequest()->response()->header( 'Access-Control-Allow-Origin: *' );
 
        if ( !$this->canHandleRequest( $subPage, $request ) ) {
            throw new HttpError( 400, wfMessage( 'pagedata-bad-title', $subPage ) );
        }
 
        $revision = 0;
 
        if ( $subPage !== '' ) {
            $parts = explode( '/', $subPage, 2 );
            $title = $parts[1] ?? '';
        } else {
            $title = $request->getText( 'target' );
        }
 
        $revision = $request->getInt( 'oldid', $revision );
        $revision = $request->getInt( 'revision', $revision );
 
        if ( $title === null || $title === '' ) {
            // TODO: different error message?
            throw new HttpError( 400, wfMessage( 'pagedata-bad-title', $title ) );
        }
 
        try {
            $title = MediaWikiServices::getInstance()->getTitleFactory()->newFromTextThrow( $title );
        } catch ( MalformedTitleException $ex ) {
            throw new HttpError( 400, wfMessage( 'pagedata-bad-title', $title ) );
        }
 
        $this->httpContentNegotiation( $request, $output, $title, $revision );
    }
 
    public function httpContentNegotiation(
        WebRequest $request,
        OutputPage $output,
        Title $title,
        $revision = 0
    ) {
        $mimeTypes = MediaWikiServices::getInstance()
            ->getContentHandlerFactory()
            ->getContentHandler( $title->getContentModel() )
            ->getSupportedFormats();
 
        $acceptHeader = $request->getHeader( 'Accept' );
        if ( $acceptHeader !== false ) {
            $parser = new HttpAcceptParser();
            $accept = $parser->parseWeights( $acceptHeader );
        } else {
            // anything goes
            $accept = [
                '*' => 0.1 // just to make extra sure
            ];
            // prefer the default
            $accept[$mimeTypes[0]] = 1;
        }
 
        $negotiator = new HttpAcceptNegotiator( $mimeTypes );
        $format = $negotiator->getBestSupportedKey( $accept );
 
        if ( $format === null ) {
            $format = isset( $accept['text/html'] ) ? 'text/html' : null;
        }
 
        if ( $format === null ) {
            throw new HttpError( 406, wfMessage( 'pagedata-not-acceptable', implode( ', ', $mimeTypes ) ) );
        }
 
        $url = $this->getDocUrl( $title, $format, $revision );
        $output->redirect( $url, 303 );
    }
 
    private function getDocUrl( Title $title, $format = '', $revision = 0 ) {
        $params = [];
 
        if ( $revision > 0 ) {
            $params['oldid'] = $revision;
        }
 
        if ( $format === 'text/html' ) {
            return $title->getFullURL( $params );
        }
 
        $params[ 'action' ] = 'raw';
 
        return $title->getFullURL( $params );
    }
 
}