3 * Virtual HTTP service client for RESTBase
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
22 * Virtual REST service for RESTBase
25 class RestbaseVirtualRESTService
extends VirtualRESTService
{
27 * Example RESTBase v1 requests:
28 * GET /local/v1/page/html/{title}{/revision}
29 * POST /local/v1/transform/html/to/wikitext{/title}{/revision}
30 * * body: array( 'html' => ... )
31 * POST /local/v1/transform/wikitext/to/html{/title}{/revision}
32 * * body: array( 'wikitext' => ... ) or array( 'wikitext' => ..., 'body_only' => true/false )
34 * @param array $params Key/value map
35 * - url : RESTBase server URL
36 * - domain : Wiki domain to use
37 * - timeout : request timeout in seconds (optional)
38 * - forwardCookies : cookies to forward to RESTBase/Parsoid (as a Cookie
39 * header string) or false (optional)
40 * Note: forwardCookies will in the future be a boolean
41 * only, signifing request cookies should be forwarded
42 * to the service; the current state is due to the way
43 * VE handles this particular parameter
44 * - HTTPProxy : HTTP proxy to use (optional)
45 * - parsoidCompat : whether to parse URL as if they were meant for Parsoid
47 * - fixedUrl : Do not append domain to the url. For example to use
48 * English Wikipedia restbase, you would this to true
49 * and url to https://en.wikipedia.org/api/rest_#version#
51 public function __construct( array $params ) {
52 // set up defaults and merge them with the given params
53 $mparams = array_merge( [
55 'url' => 'http://localhost:7231/',
56 'domain' => 'localhost',
58 'forwardCookies' => false,
60 'parsoidCompat' => false,
63 // Ensure that the url parameter has a trailing slash.
64 if ( substr( $mparams['url'], -1 ) !== '/' ) {
65 $mparams['url'] .= '/';
67 // Ensure the correct domain format: strip protocol, port,
68 // and trailing slash if present. This lets us use
69 // $wgCanonicalServer as a default value, which is very convenient.
70 $mparams['domain'] = preg_replace(
71 '/^(https?:\/\/)?([^\/:]+?)(:\d+)?\/?$/',
75 parent
::__construct( $mparams );
78 public function onRequests( array $reqs, Closure
$idGenFunc ) {
79 if ( $this->params
['parsoidCompat'] ) {
80 return $this->onParsoidRequests( $reqs, $idGenFunc );
84 foreach ( $reqs as $key => $req ) {
85 if ( $this->params
['fixedUrl'] ) {
86 $version = explode( '/', $req['url'] )[1];
88 str_replace( '#version#', $version, $this->params
['url'] ) .
89 preg_replace( '#^local/v./#', '', $req['url'] );
91 // replace /local/ with the current domain
92 $req['url'] = preg_replace( '#^local/#', $this->params
['domain'] . '/', $req['url'] );
93 // and prefix it with the service URL
94 $req['url'] = $this->params
['url'] . $req['url'];
97 // set the appropriate proxy, timeout and headers
98 if ( $this->params
['HTTPProxy'] ) {
99 $req['proxy'] = $this->params
['HTTPProxy'];
101 if ( $this->params
['timeout'] != null ) {
102 $req['reqTimeout'] = $this->params
['timeout'];
104 if ( $this->params
['forwardCookies'] ) {
105 $req['headers']['Cookie'] = $this->params
['forwardCookies'];
107 $result[$key] = $req;
114 * Remaps Parsoid v3 requests to RESTBase v1 requests.
116 * @param Closure $idGeneratorFunc
120 public function onParsoidRequests( array $reqs, Closure
$idGeneratorFunc ) {
122 foreach ( $reqs as $key => $req ) {
123 $version = explode( '/', $req['url'] )[1];
124 if ( $version === 'v3' ) {
125 $result[$key] = $this->onParsoid3Request( $req, $idGeneratorFunc );
127 throw new Exception( "Only Parsoid v3 is supported." );
135 * Remap a Parsoid v3 request to a RESTBase v1 request.
137 * Example Parsoid v3 requests:
138 * GET /local/v3/page/html/$title/{$revision}
139 * * $revision is optional
140 * POST /local/v3/transform/html/to/wikitext/{$title}{/$revision}
141 * * body: array( 'html' => ... )
142 * * $title and $revision are optional
143 * POST /local/v3/transform/wikitext/to/html/{$title}{/$revision}
144 * * body: array( 'wikitext' => ... ) or array( 'wikitext' => ..., 'body_only' => true/false )
145 * * $title is optional
146 * * $revision is optional
148 * @param Closure $idGeneratorFunc
152 public function onParsoid3Request( array $req, Closure
$idGeneratorFunc ) {
153 $parts = explode( '/', $req['url'] );
155 $targetWiki, // 'local'
157 $action, // 'transform' or 'page'
158 $format, // 'html' or 'wikitext'
159 // $title, // optional
160 // $revision, // optional
162 if ( $targetWiki !== 'local' ) {
163 throw new Exception( "Only 'local' target wiki is currently supported" );
164 } elseif ( $version !== 'v3' ) {
165 throw new Exception( "Version mismatch: should not happen." );
167 // replace /local/ with the current domain, change v3 to v1,
168 $req['url'] = preg_replace( '#^local/v3/#', $this->params
['domain'] . '/v1/', $req['url'] );
169 // and prefix it with the service URL
170 $req['url'] = $this->params
['url'] . $req['url'];
171 // set the appropriate proxy, timeout and headers
172 if ( $this->params
['HTTPProxy'] ) {
173 $req['proxy'] = $this->params
['HTTPProxy'];
175 if ( $this->params
['timeout'] != null ) {
176 $req['reqTimeout'] = $this->params
['timeout'];
178 if ( $this->params
['forwardCookies'] ) {
179 $req['headers']['Cookie'] = $this->params
['forwardCookies'];