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 v1/v3 requests to RESTBase v1 requests.
116 public function onParsoidRequests( array $reqs, Closure
$idGeneratorFunc ) {
118 foreach ( $reqs as $key => $req ) {
119 $version = explode( '/', $req['url'] )[1];
120 if ( $version === 'v3' ) {
121 $result[$key] = $this->onParsoid3Request( $req, $idGeneratorFunc );
122 } elseif ( $version === 'v1' ) {
123 $result[$key] = $this->onParsoid1Request( $req, $idGeneratorFunc );
125 throw new Exception( "Only v1 and v3 are supported." );
133 * Remap a Parsoid v1 request to a RESTBase v1 request.
135 * Example Parsoid v1 requests:
136 * GET /local/v1/page/$title/html/$oldid
137 * * $oldid is optional
138 * POST /local/v1/transform/html/to/wikitext/$title/$oldid
139 * * body: array( 'html' => ... )
140 * * $title and $oldid are optional
141 * POST /local/v1/transform/wikitext/to/html/$title
142 * * body: array( 'wikitext' => ... ) or array( 'wikitext' => ..., 'body' => true/false )
143 * * $title is optional
145 * NOTE: the POST APIs aren't "real" Parsoid v1 APIs, they are just what
146 * Visual Editor "pretends" the V1 API is like. (See
147 * ParsoidVirtualRESTService.)
149 public function onParsoid1Request( array $req, Closure
$idGeneratorFunc ) {
150 $parts = explode( '/', $req['url'] );
152 $targetWiki, // 'local'
154 $reqType // 'page' or 'transform'
156 if ( $targetWiki !== 'local' ) {
157 throw new Exception( "Only 'local' target wiki is currently supported" );
158 } elseif ( $version !== 'v1' ) {
159 throw new Exception( "Version mismatch: should not happen." );
160 } elseif ( $reqType !== 'page' && $reqType !== 'transform' ) {
161 throw new Exception( "Request type must be either 'page' or 'transform'" );
163 $req['url'] = $this->params
['url'] . $this->params
['domain'] . '/v1/' . $reqType . '/';
164 if ( $reqType === 'page' ) {
166 if ( $parts[4] !== 'html' ) {
167 throw new Exception( "Only 'html' output format is currently supported" );
169 $req['url'] .= 'html/' . $title;
170 if ( isset( $parts[5] ) ) {
171 $req['url'] .= '/' . $parts[5];
172 } elseif ( isset( $req['query']['oldid'] ) && $req['query']['oldid'] ) {
173 $req['url'] .= '/' . $req['query']['oldid'];
174 unset( $req['query']['oldid'] );
176 } elseif ( $reqType === 'transform' ) {
177 // from / to transform
178 $req['url'] .= $parts[3] . '/to/' . $parts[5];
180 if ( isset( $parts[6] ) ) {
181 $req['url'] .= '/' . $parts[6];
184 if ( isset( $parts[7] ) ) {
185 $req['url'] .= '/' . $parts[7];
186 } elseif ( isset( $req['body']['oldid'] ) && $req['body']['oldid'] ) {
187 $req['url'] .= '/' . $req['body']['oldid'];
188 unset( $req['body']['oldid'] );
190 if ( $parts[4] !== 'to' ) {
191 throw new Exception( "Part index 4 is not 'to'" );
193 if ( $parts[3] === 'html' && $parts[5] === 'wikitext' ) {
194 if ( !isset( $req['body']['html'] ) ) {
195 throw new Exception( "You must set an 'html' body key for this request" );
197 } elseif ( $parts[3] == 'wikitext' && $parts[5] == 'html' ) {
198 if ( !isset( $req['body']['wikitext'] ) ) {
199 throw new Exception( "You must set a 'wikitext' body key for this request" );
201 if ( isset( $req['body']['body'] ) ) {
202 $req['body']['body_only'] = $req['body']['body'];
203 unset( $req['body']['body'] );
206 throw new Exception( "Transformation unsupported" );
209 // set the appropriate proxy, timeout and headers
210 if ( $this->params
['HTTPProxy'] ) {
211 $req['proxy'] = $this->params
['HTTPProxy'];
213 if ( $this->params
['timeout'] != null ) {
214 $req['reqTimeout'] = $this->params
['timeout'];
216 if ( $this->params
['forwardCookies'] ) {
217 $req['headers']['Cookie'] = $this->params
['forwardCookies'];
224 * Remap a Parsoid v3 request to a RESTBase v1 request.
226 * Example Parsoid v3 requests:
227 * GET /local/v3/page/html/$title/{$revision}
228 * * $revision is optional
229 * POST /local/v3/transform/html/to/wikitext/{$title}{/$revision}
230 * * body: array( 'html' => ... )
231 * * $title and $revision are optional
232 * POST /local/v3/transform/wikitext/to/html/{$title}{/$revision}
233 * * body: array( 'wikitext' => ... ) or array( 'wikitext' => ..., 'body_only' => true/false )
234 * * $title is optional
235 * * $revision is optional
237 public function onParsoid3Request( array $req, Closure
$idGeneratorFunc ) {
238 $parts = explode( '/', $req['url'] );
240 $targetWiki, // 'local'
242 $action, // 'transform' or 'page'
243 $format, // 'html' or 'wikitext'
244 // $title, // optional
245 // $revision, // optional
247 if ( $targetWiki !== 'local' ) {
248 throw new Exception( "Only 'local' target wiki is currently supported" );
249 } elseif ( $version !== 'v3' ) {
250 throw new Exception( "Version mismatch: should not happen." );
252 // replace /local/ with the current domain, change v3 to v1,
253 $req['url'] = preg_replace( '#^local/v3/#', $this->params
['domain'] . '/v1/', $req['url'] );
254 // and prefix it with the service URL
255 $req['url'] = $this->params
['url'] . $req['url'];
256 // set the appropriate proxy, timeout and headers
257 if ( $this->params
['HTTPProxy'] ) {
258 $req['proxy'] = $this->params
['HTTPProxy'];
260 if ( $this->params
['timeout'] != null ) {
261 $req['reqTimeout'] = $this->params
['timeout'];
263 if ( $this->params
['forwardCookies'] ) {
264 $req['headers']['Cookie'] = $this->params
['forwardCookies'];