ParsoidVirtualRESTService.php

Go to the documentation of this file.

<?php
class ParsoidVirtualRESTService extends VirtualRESTService {
    public function __construct( array $params ) {
        // for backwards compatibility:
        if ( isset( $params['URL'] ) ) {
            $params['url'] = $params['URL'];
            unset( $params['URL'] );
        }
        // set up defaults and merge them with the given params
        $mparams = array_merge( [
            'name' => 'parsoid',
            'url' => 'http://localhost:8000/',
            'prefix' => 'localhost',
            'domain' => 'localhost',
            'timeout' => null,
            'forwardCookies' => false,
            'HTTPProxy' => null,
        ], $params );
        // Ensure that the url parameter has a trailing slash.
        if ( substr( $mparams['url'], -1 ) !== '/' ) {
            $mparams['url'] .= '/';
        }
        // Ensure the correct domain format: strip protocol, port,
        // and trailing slash if present.  This lets us use
        // $wgCanonicalServer as a default value, which is very convenient.
        $mparams['domain'] = preg_replace(
            '/^(https?:\/\/)?([^\/:]+?)(:\d+)?\/?$/',
            '$2',
            $mparams['domain']
        );
        parent::__construct( $mparams );
    }
 
    public function onRequests( array $reqs, Closure $idGeneratorFunc ) {
        $result = [];
        foreach ( $reqs as $key => $req ) {
            $parts = explode( '/', $req['url'] );
 
            list(
                $targetWiki, // 'local'
                $version, // 'v3' ('v1' for restbase compatibility)
                $reqType, // 'page' or 'transform'
                $format, // 'html' or 'wikitext'
                // $title (optional)
                // $revision (optional)
            ) = $parts;
 
            if ( isset( $this->params['restbaseCompat'] ) && $this->params['restbaseCompat'] ) {
                if ( $version !== 'v1' ) {
                    throw new Exception( "Only RESTBase v1 API is supported." );
                }
                # Map RESTBase v1 API to Parsoid v3 API (pretty easy)
                $req['url'] = preg_replace( '#^local/v1/#', 'local/v3/', $req['url'] );
            } elseif ( $version !== 'v3' ) {
                throw new Exception( "Only Parsoid v3 API is supported." );
            }
            if ( $targetWiki !== 'local' ) {
                throw new Exception( "Only 'local' target wiki is currently supported" );
            }
            if ( $reqType !== 'page' && $reqType !== 'transform' ) {
                throw new Exception( "Request action must be either 'page' or 'transform'" );
            }
            if ( $format !== 'html' && $format !== 'wikitext' ) {
                throw new Exception( "Request format must be either 'html' or 'wt'" );
            }
            // replace /local/ with the current domain
            $req['url'] = preg_replace( '#^local/#', $this->params['domain'] . '/', $req['url'] );
            // and prefix it with the service URL
            $req['url'] = $this->params['url'] . $req['url'];
            // set the appropriate proxy, timeout and headers
            if ( $this->params['HTTPProxy'] ) {
                $req['proxy'] = $this->params['HTTPProxy'];
            }
            if ( $this->params['timeout'] != null ) {
                $req['reqTimeout'] = $this->params['timeout'];
            }
            if ( $this->params['forwardCookies'] ) {
                $req['headers']['Cookie'] = $this->params['forwardCookies'];
            }
            $result[$key] = $req;
        }
        return $result;
    }
 
}