1
|
|
|
<?php |
2
|
|
|
/** |
3
|
|
|
* |
4
|
|
|
* |
5
|
|
|
* Created on Sep 24, 2006 |
6
|
|
|
* |
7
|
|
|
* Copyright © 2006, 2013 Yuri Astrakhan "<Firstname><Lastname>@gmail.com" |
8
|
|
|
* |
9
|
|
|
* This program is free software; you can redistribute it and/or modify |
10
|
|
|
* it under the terms of the GNU General Public License as published by |
11
|
|
|
* the Free Software Foundation; either version 2 of the License, or |
12
|
|
|
* (at your option) any later version. |
13
|
|
|
* |
14
|
|
|
* This program is distributed in the hope that it will be useful, |
15
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
16
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
17
|
|
|
* GNU General Public License for more details. |
18
|
|
|
* |
19
|
|
|
* You should have received a copy of the GNU General Public License along |
20
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc., |
21
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
22
|
|
|
* http://www.gnu.org/copyleft/gpl.html |
23
|
|
|
* |
24
|
|
|
* @file |
25
|
|
|
*/ |
26
|
|
|
|
27
|
|
|
/** |
28
|
|
|
* This class contains a list of pages that the client has requested. |
29
|
|
|
* Initially, when the client passes in titles=, pageids=, or revisions= |
30
|
|
|
* parameter, an instance of the ApiPageSet class will normalize titles, |
31
|
|
|
* determine if the pages/revisions exist, and prefetch any additional page |
32
|
|
|
* data requested. |
33
|
|
|
* |
34
|
|
|
* When a generator is used, the result of the generator will become the input |
35
|
|
|
* for the second instance of this class, and all subsequent actions will use |
36
|
|
|
* the second instance for all their work. |
37
|
|
|
* |
38
|
|
|
* @ingroup API |
39
|
|
|
* @since 1.21 derives from ApiBase instead of ApiQueryBase |
40
|
|
|
*/ |
41
|
|
|
class ApiPageSet extends ApiBase { |
42
|
|
|
/** |
43
|
|
|
* Constructor flag: The new instance of ApiPageSet will ignore the 'generator=' parameter |
44
|
|
|
* @since 1.21 |
45
|
|
|
*/ |
46
|
|
|
const DISABLE_GENERATORS = 1; |
47
|
|
|
|
48
|
|
|
private $mDbSource; |
49
|
|
|
private $mParams; |
50
|
|
|
private $mResolveRedirects; |
51
|
|
|
private $mConvertTitles; |
52
|
|
|
private $mAllowGenerator; |
53
|
|
|
|
54
|
|
|
private $mAllPages = []; // [ns][dbkey] => page_id or negative when missing |
55
|
|
|
private $mTitles = []; |
56
|
|
|
private $mGoodAndMissingPages = []; // [ns][dbkey] => page_id or negative when missing |
57
|
|
|
private $mGoodPages = []; // [ns][dbkey] => page_id |
58
|
|
|
private $mGoodTitles = []; |
59
|
|
|
private $mMissingPages = []; // [ns][dbkey] => fake page_id |
60
|
|
|
private $mMissingTitles = []; |
61
|
|
|
/** @var array [fake_page_id] => [ 'title' => $title, 'invalidreason' => $reason ] */ |
62
|
|
|
private $mInvalidTitles = []; |
63
|
|
|
private $mMissingPageIDs = []; |
64
|
|
|
private $mRedirectTitles = []; |
65
|
|
|
private $mSpecialTitles = []; |
66
|
|
|
private $mNormalizedTitles = []; |
67
|
|
|
private $mInterwikiTitles = []; |
68
|
|
|
/** @var Title[] */ |
69
|
|
|
private $mPendingRedirectIDs = []; |
70
|
|
|
private $mResolvedRedirectTitles = []; |
71
|
|
|
private $mConvertedTitles = []; |
72
|
|
|
private $mGoodRevIDs = []; |
73
|
|
|
private $mLiveRevIDs = []; |
74
|
|
|
private $mDeletedRevIDs = []; |
75
|
|
|
private $mMissingRevIDs = []; |
76
|
|
|
private $mGeneratorData = []; // [ns][dbkey] => data array |
77
|
|
|
private $mFakePageId = -1; |
78
|
|
|
private $mCacheMode = 'public'; |
79
|
|
|
private $mRequestedPageFields = []; |
80
|
|
|
/** @var int */ |
81
|
|
|
private $mDefaultNamespace = NS_MAIN; |
82
|
|
|
/** @var callable|null */ |
83
|
|
|
private $mRedirectMergePolicy; |
84
|
|
|
|
85
|
|
|
/** |
86
|
|
|
* Add all items from $values into the result |
87
|
|
|
* @param array $result Output |
88
|
|
|
* @param array $values Values to add |
89
|
|
|
* @param string $flag The name of the boolean flag to mark this element |
90
|
|
|
* @param string $name If given, name of the value |
91
|
|
|
*/ |
92
|
|
View Code Duplication |
private static function addValues( array &$result, $values, $flag = null, $name = null ) { |
93
|
|
|
foreach ( $values as $val ) { |
94
|
|
|
if ( $val instanceof Title ) { |
95
|
|
|
$v = []; |
96
|
|
|
ApiQueryBase::addTitleInfo( $v, $val ); |
97
|
|
|
} elseif ( $name !== null ) { |
98
|
|
|
$v = [ $name => $val ]; |
99
|
|
|
} else { |
100
|
|
|
$v = $val; |
101
|
|
|
} |
102
|
|
|
if ( $flag !== null ) { |
103
|
|
|
$v[$flag] = true; |
104
|
|
|
} |
105
|
|
|
$result[] = $v; |
106
|
|
|
} |
107
|
|
|
} |
108
|
|
|
|
109
|
|
|
/** |
110
|
|
|
* @param ApiBase $dbSource Module implementing getDB(). |
111
|
|
|
* Allows PageSet to reuse existing db connection from the shared state like ApiQuery. |
112
|
|
|
* @param int $flags Zero or more flags like DISABLE_GENERATORS |
113
|
|
|
* @param int $defaultNamespace The namespace to use if none is specified by a prefix. |
114
|
|
|
* @since 1.21 accepts $flags instead of two boolean values |
115
|
|
|
*/ |
116
|
|
|
public function __construct( ApiBase $dbSource, $flags = 0, $defaultNamespace = NS_MAIN ) { |
117
|
|
|
parent::__construct( $dbSource->getMain(), $dbSource->getModuleName() ); |
118
|
|
|
$this->mDbSource = $dbSource; |
119
|
|
|
$this->mAllowGenerator = ( $flags & ApiPageSet::DISABLE_GENERATORS ) == 0; |
120
|
|
|
$this->mDefaultNamespace = $defaultNamespace; |
121
|
|
|
|
122
|
|
|
$this->mParams = $this->extractRequestParams(); |
123
|
|
|
$this->mResolveRedirects = $this->mParams['redirects']; |
124
|
|
|
$this->mConvertTitles = $this->mParams['converttitles']; |
125
|
|
|
} |
126
|
|
|
|
127
|
|
|
/** |
128
|
|
|
* In case execute() is not called, call this method to mark all relevant parameters as used |
129
|
|
|
* This prevents unused parameters from being reported as warnings |
130
|
|
|
*/ |
131
|
|
|
public function executeDryRun() { |
132
|
|
|
$this->executeInternal( true ); |
133
|
|
|
} |
134
|
|
|
|
135
|
|
|
/** |
136
|
|
|
* Populate the PageSet from the request parameters. |
137
|
|
|
*/ |
138
|
|
|
public function execute() { |
139
|
|
|
$this->executeInternal( false ); |
140
|
|
|
} |
141
|
|
|
|
142
|
|
|
/** |
143
|
|
|
* Populate the PageSet from the request parameters. |
144
|
|
|
* @param bool $isDryRun If true, instantiates generator, but only to mark |
145
|
|
|
* relevant parameters as used |
146
|
|
|
*/ |
147
|
|
|
private function executeInternal( $isDryRun ) { |
148
|
|
|
$generatorName = $this->mAllowGenerator ? $this->mParams['generator'] : null; |
149
|
|
|
if ( isset( $generatorName ) ) { |
150
|
|
|
$dbSource = $this->mDbSource; |
151
|
|
|
if ( !$dbSource instanceof ApiQuery ) { |
152
|
|
|
// If the parent container of this pageset is not ApiQuery, we must create it to run generator |
153
|
|
|
$dbSource = $this->getMain()->getModuleManager()->getModule( 'query' ); |
154
|
|
|
} |
155
|
|
|
$generator = $dbSource->getModuleManager()->getModule( $generatorName, null, true ); |
156
|
|
|
if ( $generator === null ) { |
157
|
|
|
$this->dieUsage( 'Unknown generator=' . $generatorName, 'badgenerator' ); |
158
|
|
|
} |
159
|
|
|
if ( !$generator instanceof ApiQueryGeneratorBase ) { |
160
|
|
|
$this->dieUsage( "Module $generatorName cannot be used as a generator", 'badgenerator' ); |
161
|
|
|
} |
162
|
|
|
// Create a temporary pageset to store generator's output, |
163
|
|
|
// add any additional fields generator may need, and execute pageset to populate titles/pageids |
164
|
|
|
$tmpPageSet = new ApiPageSet( $dbSource, ApiPageSet::DISABLE_GENERATORS ); |
|
|
|
|
165
|
|
|
$generator->setGeneratorMode( $tmpPageSet ); |
166
|
|
|
$this->mCacheMode = $generator->getCacheMode( $generator->extractRequestParams() ); |
167
|
|
|
|
168
|
|
|
if ( !$isDryRun ) { |
169
|
|
|
$generator->requestExtraData( $tmpPageSet ); |
170
|
|
|
} |
171
|
|
|
$tmpPageSet->executeInternal( $isDryRun ); |
172
|
|
|
|
173
|
|
|
// populate this pageset with the generator output |
174
|
|
|
if ( !$isDryRun ) { |
175
|
|
|
$generator->executeGenerator( $this ); |
176
|
|
|
Hooks::run( 'APIQueryGeneratorAfterExecute', [ &$generator, &$this ] ); |
177
|
|
|
} else { |
178
|
|
|
// Prevent warnings from being reported on these parameters |
179
|
|
|
$main = $this->getMain(); |
180
|
|
|
foreach ( $generator->extractRequestParams() as $paramName => $param ) { |
181
|
|
|
$main->markParamsUsed( $generator->encodeParamName( $paramName ) ); |
182
|
|
|
} |
183
|
|
|
} |
184
|
|
|
|
185
|
|
|
if ( !$isDryRun ) { |
186
|
|
|
$this->resolvePendingRedirects(); |
187
|
|
|
} |
188
|
|
|
} else { |
189
|
|
|
// Only one of the titles/pageids/revids is allowed at the same time |
190
|
|
|
$dataSource = null; |
191
|
|
|
if ( isset( $this->mParams['titles'] ) ) { |
192
|
|
|
$dataSource = 'titles'; |
193
|
|
|
} |
194
|
|
View Code Duplication |
if ( isset( $this->mParams['pageids'] ) ) { |
195
|
|
|
if ( isset( $dataSource ) ) { |
196
|
|
|
$this->dieUsage( "Cannot use 'pageids' at the same time as '$dataSource'", 'multisource' ); |
197
|
|
|
} |
198
|
|
|
$dataSource = 'pageids'; |
199
|
|
|
} |
200
|
|
View Code Duplication |
if ( isset( $this->mParams['revids'] ) ) { |
201
|
|
|
if ( isset( $dataSource ) ) { |
202
|
|
|
$this->dieUsage( "Cannot use 'revids' at the same time as '$dataSource'", 'multisource' ); |
203
|
|
|
} |
204
|
|
|
$dataSource = 'revids'; |
205
|
|
|
} |
206
|
|
|
|
207
|
|
|
if ( !$isDryRun ) { |
208
|
|
|
// Populate page information with the original user input |
209
|
|
|
switch ( $dataSource ) { |
210
|
|
|
case 'titles': |
211
|
|
|
$this->initFromTitles( $this->mParams['titles'] ); |
212
|
|
|
break; |
213
|
|
|
case 'pageids': |
214
|
|
|
$this->initFromPageIds( $this->mParams['pageids'] ); |
215
|
|
|
break; |
216
|
|
|
case 'revids': |
217
|
|
|
if ( $this->mResolveRedirects ) { |
218
|
|
|
$this->setWarning( 'Redirect resolution cannot be used ' . |
219
|
|
|
'together with the revids= parameter. Any redirects ' . |
220
|
|
|
'the revids= point to have not been resolved.' ); |
221
|
|
|
} |
222
|
|
|
$this->mResolveRedirects = false; |
223
|
|
|
$this->initFromRevIDs( $this->mParams['revids'] ); |
224
|
|
|
break; |
225
|
|
|
default: |
226
|
|
|
// Do nothing - some queries do not need any of the data sources. |
227
|
|
|
break; |
228
|
|
|
} |
229
|
|
|
} |
230
|
|
|
} |
231
|
|
|
} |
232
|
|
|
|
233
|
|
|
/** |
234
|
|
|
* Check whether this PageSet is resolving redirects |
235
|
|
|
* @return bool |
236
|
|
|
*/ |
237
|
|
|
public function isResolvingRedirects() { |
238
|
|
|
return $this->mResolveRedirects; |
239
|
|
|
} |
240
|
|
|
|
241
|
|
|
/** |
242
|
|
|
* Return the parameter name that is the source of data for this PageSet |
243
|
|
|
* |
244
|
|
|
* If multiple source parameters are specified (e.g. titles and pageids), |
245
|
|
|
* one will be named arbitrarily. |
246
|
|
|
* |
247
|
|
|
* @return string|null |
248
|
|
|
*/ |
249
|
|
|
public function getDataSource() { |
250
|
|
|
if ( $this->mAllowGenerator && isset( $this->mParams['generator'] ) ) { |
251
|
|
|
return 'generator'; |
252
|
|
|
} |
253
|
|
|
if ( isset( $this->mParams['titles'] ) ) { |
254
|
|
|
return 'titles'; |
255
|
|
|
} |
256
|
|
|
if ( isset( $this->mParams['pageids'] ) ) { |
257
|
|
|
return 'pageids'; |
258
|
|
|
} |
259
|
|
|
if ( isset( $this->mParams['revids'] ) ) { |
260
|
|
|
return 'revids'; |
261
|
|
|
} |
262
|
|
|
|
263
|
|
|
return null; |
264
|
|
|
} |
265
|
|
|
|
266
|
|
|
/** |
267
|
|
|
* Request an additional field from the page table. |
268
|
|
|
* Must be called before execute() |
269
|
|
|
* @param string $fieldName Field name |
270
|
|
|
*/ |
271
|
|
|
public function requestField( $fieldName ) { |
272
|
|
|
$this->mRequestedPageFields[$fieldName] = null; |
273
|
|
|
} |
274
|
|
|
|
275
|
|
|
/** |
276
|
|
|
* Get the value of a custom field previously requested through |
277
|
|
|
* requestField() |
278
|
|
|
* @param string $fieldName Field name |
279
|
|
|
* @return mixed Field value |
280
|
|
|
*/ |
281
|
|
|
public function getCustomField( $fieldName ) { |
282
|
|
|
return $this->mRequestedPageFields[$fieldName]; |
283
|
|
|
} |
284
|
|
|
|
285
|
|
|
/** |
286
|
|
|
* Get the fields that have to be queried from the page table: |
287
|
|
|
* the ones requested through requestField() and a few basic ones |
288
|
|
|
* we always need |
289
|
|
|
* @return array Array of field names |
290
|
|
|
*/ |
291
|
|
|
public function getPageTableFields() { |
292
|
|
|
// Ensure we get minimum required fields |
293
|
|
|
// DON'T change this order |
294
|
|
|
$pageFlds = [ |
295
|
|
|
'page_namespace' => null, |
296
|
|
|
'page_title' => null, |
297
|
|
|
'page_id' => null, |
298
|
|
|
]; |
299
|
|
|
|
300
|
|
|
if ( $this->mResolveRedirects ) { |
301
|
|
|
$pageFlds['page_is_redirect'] = null; |
302
|
|
|
} |
303
|
|
|
|
304
|
|
|
if ( $this->getConfig()->get( 'ContentHandlerUseDB' ) ) { |
305
|
|
|
$pageFlds['page_content_model'] = null; |
306
|
|
|
} |
307
|
|
|
|
308
|
|
|
if ( $this->getConfig()->get( 'PageLanguageUseDB' ) ) { |
309
|
|
|
$pageFlds['page_lang'] = null; |
310
|
|
|
} |
311
|
|
|
|
312
|
|
|
// only store non-default fields |
313
|
|
|
$this->mRequestedPageFields = array_diff_key( $this->mRequestedPageFields, $pageFlds ); |
314
|
|
|
|
315
|
|
|
$pageFlds = array_merge( $pageFlds, $this->mRequestedPageFields ); |
316
|
|
|
|
317
|
|
|
return array_keys( $pageFlds ); |
318
|
|
|
} |
319
|
|
|
|
320
|
|
|
/** |
321
|
|
|
* Returns an array [ns][dbkey] => page_id for all requested titles. |
322
|
|
|
* page_id is a unique negative number in case title was not found. |
323
|
|
|
* Invalid titles will also have negative page IDs and will be in namespace 0 |
324
|
|
|
* @return array |
325
|
|
|
*/ |
326
|
|
|
public function getAllTitlesByNamespace() { |
327
|
|
|
return $this->mAllPages; |
328
|
|
|
} |
329
|
|
|
|
330
|
|
|
/** |
331
|
|
|
* All Title objects provided. |
332
|
|
|
* @return Title[] |
333
|
|
|
*/ |
334
|
|
|
public function getTitles() { |
335
|
|
|
return $this->mTitles; |
336
|
|
|
} |
337
|
|
|
|
338
|
|
|
/** |
339
|
|
|
* Returns the number of unique pages (not revisions) in the set. |
340
|
|
|
* @return int |
341
|
|
|
*/ |
342
|
|
|
public function getTitleCount() { |
343
|
|
|
return count( $this->mTitles ); |
344
|
|
|
} |
345
|
|
|
|
346
|
|
|
/** |
347
|
|
|
* Returns an array [ns][dbkey] => page_id for all good titles. |
348
|
|
|
* @return array |
349
|
|
|
*/ |
350
|
|
|
public function getGoodTitlesByNamespace() { |
351
|
|
|
return $this->mGoodPages; |
352
|
|
|
} |
353
|
|
|
|
354
|
|
|
/** |
355
|
|
|
* Title objects that were found in the database. |
356
|
|
|
* @return Title[] Array page_id (int) => Title (obj) |
357
|
|
|
*/ |
358
|
|
|
public function getGoodTitles() { |
359
|
|
|
return $this->mGoodTitles; |
360
|
|
|
} |
361
|
|
|
|
362
|
|
|
/** |
363
|
|
|
* Returns the number of found unique pages (not revisions) in the set. |
364
|
|
|
* @return int |
365
|
|
|
*/ |
366
|
|
|
public function getGoodTitleCount() { |
367
|
|
|
return count( $this->mGoodTitles ); |
368
|
|
|
} |
369
|
|
|
|
370
|
|
|
/** |
371
|
|
|
* Returns an array [ns][dbkey] => fake_page_id for all missing titles. |
372
|
|
|
* fake_page_id is a unique negative number. |
373
|
|
|
* @return array |
374
|
|
|
*/ |
375
|
|
|
public function getMissingTitlesByNamespace() { |
376
|
|
|
return $this->mMissingPages; |
377
|
|
|
} |
378
|
|
|
|
379
|
|
|
/** |
380
|
|
|
* Title objects that were NOT found in the database. |
381
|
|
|
* The array's index will be negative for each item |
382
|
|
|
* @return Title[] |
383
|
|
|
*/ |
384
|
|
|
public function getMissingTitles() { |
385
|
|
|
return $this->mMissingTitles; |
386
|
|
|
} |
387
|
|
|
|
388
|
|
|
/** |
389
|
|
|
* Returns an array [ns][dbkey] => page_id for all good and missing titles. |
390
|
|
|
* @return array |
391
|
|
|
*/ |
392
|
|
|
public function getGoodAndMissingTitlesByNamespace() { |
393
|
|
|
return $this->mGoodAndMissingPages; |
394
|
|
|
} |
395
|
|
|
|
396
|
|
|
/** |
397
|
|
|
* Title objects for good and missing titles. |
398
|
|
|
* @return array |
399
|
|
|
*/ |
400
|
|
|
public function getGoodAndMissingTitles() { |
401
|
|
|
return $this->mGoodTitles + $this->mMissingTitles; |
402
|
|
|
} |
403
|
|
|
|
404
|
|
|
/** |
405
|
|
|
* Titles that were deemed invalid by Title::newFromText() |
406
|
|
|
* The array's index will be unique and negative for each item |
407
|
|
|
* @deprecated since 1.26, use self::getInvalidTitlesAndReasons() |
408
|
|
|
* @return string[] Array of strings (not Title objects) |
409
|
|
|
*/ |
410
|
|
|
public function getInvalidTitles() { |
411
|
|
|
wfDeprecated( __METHOD__, '1.26' ); |
412
|
|
|
return array_map( function ( $t ) { |
413
|
|
|
return $t['title']; |
414
|
|
|
}, $this->mInvalidTitles ); |
415
|
|
|
} |
416
|
|
|
|
417
|
|
|
/** |
418
|
|
|
* Titles that were deemed invalid by Title::newFromText() |
419
|
|
|
* The array's index will be unique and negative for each item |
420
|
|
|
* @return array[] Array of arrays with 'title' and 'invalidreason' properties |
421
|
|
|
*/ |
422
|
|
|
public function getInvalidTitlesAndReasons() { |
423
|
|
|
return $this->mInvalidTitles; |
424
|
|
|
} |
425
|
|
|
|
426
|
|
|
/** |
427
|
|
|
* Page IDs that were not found in the database |
428
|
|
|
* @return array Array of page IDs |
429
|
|
|
*/ |
430
|
|
|
public function getMissingPageIDs() { |
431
|
|
|
return $this->mMissingPageIDs; |
432
|
|
|
} |
433
|
|
|
|
434
|
|
|
/** |
435
|
|
|
* Get a list of redirect resolutions - maps a title to its redirect |
436
|
|
|
* target, as an array of output-ready arrays |
437
|
|
|
* @return Title[] |
438
|
|
|
*/ |
439
|
|
|
public function getRedirectTitles() { |
440
|
|
|
return $this->mRedirectTitles; |
441
|
|
|
} |
442
|
|
|
|
443
|
|
|
/** |
444
|
|
|
* Get a list of redirect resolutions - maps a title to its redirect |
445
|
|
|
* target. Includes generator data for redirect source when available. |
446
|
|
|
* @param ApiResult $result |
447
|
|
|
* @return array Array of prefixed_title (string) => Title object |
448
|
|
|
* @since 1.21 |
449
|
|
|
*/ |
450
|
|
|
public function getRedirectTitlesAsResult( $result = null ) { |
451
|
|
|
$values = []; |
452
|
|
|
foreach ( $this->getRedirectTitles() as $titleStrFrom => $titleTo ) { |
453
|
|
|
$r = [ |
454
|
|
|
'from' => strval( $titleStrFrom ), |
455
|
|
|
'to' => $titleTo->getPrefixedText(), |
456
|
|
|
]; |
457
|
|
|
if ( $titleTo->hasFragment() ) { |
458
|
|
|
$r['tofragment'] = $titleTo->getFragment(); |
459
|
|
|
} |
460
|
|
|
if ( $titleTo->isExternal() ) { |
461
|
|
|
$r['tointerwiki'] = $titleTo->getInterwiki(); |
462
|
|
|
} |
463
|
|
|
if ( isset( $this->mResolvedRedirectTitles[$titleStrFrom] ) ) { |
464
|
|
|
$titleFrom = $this->mResolvedRedirectTitles[$titleStrFrom]; |
465
|
|
|
$ns = $titleFrom->getNamespace(); |
466
|
|
|
$dbkey = $titleFrom->getDBkey(); |
467
|
|
|
if ( isset( $this->mGeneratorData[$ns][$dbkey] ) ) { |
468
|
|
|
$r = array_merge( $this->mGeneratorData[$ns][$dbkey], $r ); |
469
|
|
|
} |
470
|
|
|
} |
471
|
|
|
|
472
|
|
|
$values[] = $r; |
473
|
|
|
} |
474
|
|
|
if ( !empty( $values ) && $result ) { |
475
|
|
|
ApiResult::setIndexedTagName( $values, 'r' ); |
476
|
|
|
} |
477
|
|
|
|
478
|
|
|
return $values; |
479
|
|
|
} |
480
|
|
|
|
481
|
|
|
/** |
482
|
|
|
* Get a list of title normalizations - maps a title to its normalized |
483
|
|
|
* version. |
484
|
|
|
* @return array Array of raw_prefixed_title (string) => prefixed_title (string) |
485
|
|
|
*/ |
486
|
|
|
public function getNormalizedTitles() { |
487
|
|
|
return $this->mNormalizedTitles; |
488
|
|
|
} |
489
|
|
|
|
490
|
|
|
/** |
491
|
|
|
* Get a list of title normalizations - maps a title to its normalized |
492
|
|
|
* version in the form of result array. |
493
|
|
|
* @param ApiResult $result |
494
|
|
|
* @return array Array of raw_prefixed_title (string) => prefixed_title (string) |
495
|
|
|
* @since 1.21 |
496
|
|
|
*/ |
497
|
|
|
public function getNormalizedTitlesAsResult( $result = null ) { |
498
|
|
|
global $wgContLang; |
499
|
|
|
|
500
|
|
|
$values = []; |
501
|
|
|
foreach ( $this->getNormalizedTitles() as $rawTitleStr => $titleStr ) { |
502
|
|
|
$encode = ( $wgContLang->normalize( $rawTitleStr ) !== $rawTitleStr ); |
503
|
|
|
$values[] = [ |
504
|
|
|
'fromencoded' => $encode, |
505
|
|
|
'from' => $encode ? rawurlencode( $rawTitleStr ) : $rawTitleStr, |
506
|
|
|
'to' => $titleStr |
507
|
|
|
]; |
508
|
|
|
} |
509
|
|
|
if ( !empty( $values ) && $result ) { |
510
|
|
|
ApiResult::setIndexedTagName( $values, 'n' ); |
511
|
|
|
} |
512
|
|
|
|
513
|
|
|
return $values; |
514
|
|
|
} |
515
|
|
|
|
516
|
|
|
/** |
517
|
|
|
* Get a list of title conversions - maps a title to its converted |
518
|
|
|
* version. |
519
|
|
|
* @return array Array of raw_prefixed_title (string) => prefixed_title (string) |
520
|
|
|
*/ |
521
|
|
|
public function getConvertedTitles() { |
522
|
|
|
return $this->mConvertedTitles; |
523
|
|
|
} |
524
|
|
|
|
525
|
|
|
/** |
526
|
|
|
* Get a list of title conversions - maps a title to its converted |
527
|
|
|
* version as a result array. |
528
|
|
|
* @param ApiResult $result |
529
|
|
|
* @return array Array of (from, to) strings |
530
|
|
|
* @since 1.21 |
531
|
|
|
*/ |
532
|
|
|
public function getConvertedTitlesAsResult( $result = null ) { |
533
|
|
|
$values = []; |
534
|
|
|
foreach ( $this->getConvertedTitles() as $rawTitleStr => $titleStr ) { |
535
|
|
|
$values[] = [ |
536
|
|
|
'from' => $rawTitleStr, |
537
|
|
|
'to' => $titleStr |
538
|
|
|
]; |
539
|
|
|
} |
540
|
|
|
if ( !empty( $values ) && $result ) { |
541
|
|
|
ApiResult::setIndexedTagName( $values, 'c' ); |
542
|
|
|
} |
543
|
|
|
|
544
|
|
|
return $values; |
545
|
|
|
} |
546
|
|
|
|
547
|
|
|
/** |
548
|
|
|
* Get a list of interwiki titles - maps a title to its interwiki |
549
|
|
|
* prefix. |
550
|
|
|
* @return array Array of raw_prefixed_title (string) => interwiki_prefix (string) |
551
|
|
|
*/ |
552
|
|
|
public function getInterwikiTitles() { |
553
|
|
|
return $this->mInterwikiTitles; |
554
|
|
|
} |
555
|
|
|
|
556
|
|
|
/** |
557
|
|
|
* Get a list of interwiki titles - maps a title to its interwiki |
558
|
|
|
* prefix as result. |
559
|
|
|
* @param ApiResult $result |
560
|
|
|
* @param bool $iwUrl |
561
|
|
|
* @return array Array of raw_prefixed_title (string) => interwiki_prefix (string) |
562
|
|
|
* @since 1.21 |
563
|
|
|
*/ |
564
|
|
|
public function getInterwikiTitlesAsResult( $result = null, $iwUrl = false ) { |
565
|
|
|
$values = []; |
566
|
|
|
foreach ( $this->getInterwikiTitles() as $rawTitleStr => $interwikiStr ) { |
567
|
|
|
$item = [ |
568
|
|
|
'title' => $rawTitleStr, |
569
|
|
|
'iw' => $interwikiStr, |
570
|
|
|
]; |
571
|
|
|
if ( $iwUrl ) { |
572
|
|
|
$title = Title::newFromText( $rawTitleStr ); |
573
|
|
|
$item['url'] = $title->getFullURL( '', false, PROTO_CURRENT ); |
574
|
|
|
} |
575
|
|
|
$values[] = $item; |
576
|
|
|
} |
577
|
|
|
if ( !empty( $values ) && $result ) { |
578
|
|
|
ApiResult::setIndexedTagName( $values, 'i' ); |
579
|
|
|
} |
580
|
|
|
|
581
|
|
|
return $values; |
582
|
|
|
} |
583
|
|
|
|
584
|
|
|
/** |
585
|
|
|
* Get an array of invalid/special/missing titles. |
586
|
|
|
* |
587
|
|
|
* @param array $invalidChecks List of types of invalid titles to include. |
588
|
|
|
* Recognized values are: |
589
|
|
|
* - invalidTitles: Titles and reasons from $this->getInvalidTitlesAndReasons() |
590
|
|
|
* - special: Titles from $this->getSpecialTitles() |
591
|
|
|
* - missingIds: ids from $this->getMissingPageIDs() |
592
|
|
|
* - missingRevIds: ids from $this->getMissingRevisionIDs() |
593
|
|
|
* - missingTitles: Titles from $this->getMissingTitles() |
594
|
|
|
* - interwikiTitles: Titles from $this->getInterwikiTitlesAsResult() |
595
|
|
|
* @return array Array suitable for inclusion in the response |
596
|
|
|
* @since 1.23 |
597
|
|
|
*/ |
598
|
|
|
public function getInvalidTitlesAndRevisions( $invalidChecks = [ 'invalidTitles', |
599
|
|
|
'special', 'missingIds', 'missingRevIds', 'missingTitles', 'interwikiTitles' ] |
600
|
|
|
) { |
601
|
|
|
$result = []; |
602
|
|
|
if ( in_array( 'invalidTitles', $invalidChecks ) ) { |
603
|
|
|
self::addValues( $result, $this->getInvalidTitlesAndReasons(), 'invalid' ); |
604
|
|
|
} |
605
|
|
|
if ( in_array( 'special', $invalidChecks ) ) { |
606
|
|
|
self::addValues( $result, $this->getSpecialTitles(), 'special', 'title' ); |
607
|
|
|
} |
608
|
|
|
if ( in_array( 'missingIds', $invalidChecks ) ) { |
609
|
|
|
self::addValues( $result, $this->getMissingPageIDs(), 'missing', 'pageid' ); |
610
|
|
|
} |
611
|
|
|
if ( in_array( 'missingRevIds', $invalidChecks ) ) { |
612
|
|
|
self::addValues( $result, $this->getMissingRevisionIDs(), 'missing', 'revid' ); |
613
|
|
|
} |
614
|
|
|
if ( in_array( 'missingTitles', $invalidChecks ) ) { |
615
|
|
|
self::addValues( $result, $this->getMissingTitles(), 'missing' ); |
616
|
|
|
} |
617
|
|
|
if ( in_array( 'interwikiTitles', $invalidChecks ) ) { |
618
|
|
|
self::addValues( $result, $this->getInterwikiTitlesAsResult() ); |
619
|
|
|
} |
620
|
|
|
|
621
|
|
|
return $result; |
622
|
|
|
} |
623
|
|
|
|
624
|
|
|
/** |
625
|
|
|
* Get the list of valid revision IDs (requested with the revids= parameter) |
626
|
|
|
* @return array Array of revID (int) => pageID (int) |
627
|
|
|
*/ |
628
|
|
|
public function getRevisionIDs() { |
629
|
|
|
return $this->mGoodRevIDs; |
630
|
|
|
} |
631
|
|
|
|
632
|
|
|
/** |
633
|
|
|
* Get the list of non-deleted revision IDs (requested with the revids= parameter) |
634
|
|
|
* @return array Array of revID (int) => pageID (int) |
635
|
|
|
*/ |
636
|
|
|
public function getLiveRevisionIDs() { |
637
|
|
|
return $this->mLiveRevIDs; |
638
|
|
|
} |
639
|
|
|
|
640
|
|
|
/** |
641
|
|
|
* Get the list of revision IDs that were associated with deleted titles. |
642
|
|
|
* @return array Array of revID (int) => pageID (int) |
643
|
|
|
*/ |
644
|
|
|
public function getDeletedRevisionIDs() { |
645
|
|
|
return $this->mDeletedRevIDs; |
646
|
|
|
} |
647
|
|
|
|
648
|
|
|
/** |
649
|
|
|
* Revision IDs that were not found in the database |
650
|
|
|
* @return array Array of revision IDs |
651
|
|
|
*/ |
652
|
|
|
public function getMissingRevisionIDs() { |
653
|
|
|
return $this->mMissingRevIDs; |
654
|
|
|
} |
655
|
|
|
|
656
|
|
|
/** |
657
|
|
|
* Revision IDs that were not found in the database as result array. |
658
|
|
|
* @param ApiResult $result |
659
|
|
|
* @return array Array of revision IDs |
660
|
|
|
* @since 1.21 |
661
|
|
|
*/ |
662
|
|
|
public function getMissingRevisionIDsAsResult( $result = null ) { |
663
|
|
|
$values = []; |
664
|
|
|
foreach ( $this->getMissingRevisionIDs() as $revid ) { |
665
|
|
|
$values[$revid] = [ |
666
|
|
|
'revid' => $revid |
667
|
|
|
]; |
668
|
|
|
} |
669
|
|
|
if ( !empty( $values ) && $result ) { |
670
|
|
|
ApiResult::setIndexedTagName( $values, 'rev' ); |
671
|
|
|
} |
672
|
|
|
|
673
|
|
|
return $values; |
674
|
|
|
} |
675
|
|
|
|
676
|
|
|
/** |
677
|
|
|
* Get the list of titles with negative namespace |
678
|
|
|
* @return Title[] |
679
|
|
|
*/ |
680
|
|
|
public function getSpecialTitles() { |
681
|
|
|
return $this->mSpecialTitles; |
682
|
|
|
} |
683
|
|
|
|
684
|
|
|
/** |
685
|
|
|
* Returns the number of revisions (requested with revids= parameter). |
686
|
|
|
* @return int Number of revisions. |
687
|
|
|
*/ |
688
|
|
|
public function getRevisionCount() { |
689
|
|
|
return count( $this->getRevisionIDs() ); |
690
|
|
|
} |
691
|
|
|
|
692
|
|
|
/** |
693
|
|
|
* Populate this PageSet from a list of Titles |
694
|
|
|
* @param array $titles Array of Title objects |
695
|
|
|
*/ |
696
|
|
|
public function populateFromTitles( $titles ) { |
697
|
|
|
$this->initFromTitles( $titles ); |
698
|
|
|
} |
699
|
|
|
|
700
|
|
|
/** |
701
|
|
|
* Populate this PageSet from a list of page IDs |
702
|
|
|
* @param array $pageIDs Array of page IDs |
703
|
|
|
*/ |
704
|
|
|
public function populateFromPageIDs( $pageIDs ) { |
705
|
|
|
$this->initFromPageIds( $pageIDs ); |
706
|
|
|
} |
707
|
|
|
|
708
|
|
|
/** |
709
|
|
|
* Populate this PageSet from a rowset returned from the database |
710
|
|
|
* |
711
|
|
|
* Note that the query result must include the columns returned by |
712
|
|
|
* $this->getPageTableFields(). |
713
|
|
|
* |
714
|
|
|
* @param IDatabase $db |
715
|
|
|
* @param ResultWrapper $queryResult Query result object |
716
|
|
|
*/ |
717
|
|
|
public function populateFromQueryResult( $db, $queryResult ) { |
718
|
|
|
$this->initFromQueryResult( $queryResult ); |
719
|
|
|
} |
720
|
|
|
|
721
|
|
|
/** |
722
|
|
|
* Populate this PageSet from a list of revision IDs |
723
|
|
|
* @param array $revIDs Array of revision IDs |
724
|
|
|
*/ |
725
|
|
|
public function populateFromRevisionIDs( $revIDs ) { |
726
|
|
|
$this->initFromRevIDs( $revIDs ); |
727
|
|
|
} |
728
|
|
|
|
729
|
|
|
/** |
730
|
|
|
* Extract all requested fields from the row received from the database |
731
|
|
|
* @param stdClass $row Result row |
732
|
|
|
*/ |
733
|
|
|
public function processDbRow( $row ) { |
734
|
|
|
// Store Title object in various data structures |
735
|
|
|
$title = Title::newFromRow( $row ); |
736
|
|
|
|
737
|
|
|
$pageId = intval( $row->page_id ); |
738
|
|
|
$this->mAllPages[$row->page_namespace][$row->page_title] = $pageId; |
739
|
|
|
$this->mTitles[] = $title; |
740
|
|
|
|
741
|
|
|
if ( $this->mResolveRedirects && $row->page_is_redirect == '1' ) { |
742
|
|
|
$this->mPendingRedirectIDs[$pageId] = $title; |
743
|
|
|
} else { |
744
|
|
|
$this->mGoodPages[$row->page_namespace][$row->page_title] = $pageId; |
745
|
|
|
$this->mGoodAndMissingPages[$row->page_namespace][$row->page_title] = $pageId; |
746
|
|
|
$this->mGoodTitles[$pageId] = $title; |
747
|
|
|
} |
748
|
|
|
|
749
|
|
|
foreach ( $this->mRequestedPageFields as $fieldName => &$fieldValues ) { |
750
|
|
|
$fieldValues[$pageId] = $row->$fieldName; |
751
|
|
|
} |
752
|
|
|
} |
753
|
|
|
|
754
|
|
|
/** |
755
|
|
|
* This method populates internal variables with page information |
756
|
|
|
* based on the given array of title strings. |
757
|
|
|
* |
758
|
|
|
* Steps: |
759
|
|
|
* #1 For each title, get data from `page` table |
760
|
|
|
* #2 If page was not found in the DB, store it as missing |
761
|
|
|
* |
762
|
|
|
* Additionally, when resolving redirects: |
763
|
|
|
* #3 If no more redirects left, stop. |
764
|
|
|
* #4 For each redirect, get its target from the `redirect` table. |
765
|
|
|
* #5 Substitute the original LinkBatch object with the new list |
766
|
|
|
* #6 Repeat from step #1 |
767
|
|
|
* |
768
|
|
|
* @param array $titles Array of Title objects or strings |
769
|
|
|
*/ |
770
|
|
|
private function initFromTitles( $titles ) { |
771
|
|
|
// Get validated and normalized title objects |
772
|
|
|
$linkBatch = $this->processTitlesArray( $titles ); |
773
|
|
|
if ( $linkBatch->isEmpty() ) { |
774
|
|
|
return; |
775
|
|
|
} |
776
|
|
|
|
777
|
|
|
$db = $this->getDB(); |
778
|
|
|
$set = $linkBatch->constructSet( 'page', $db ); |
779
|
|
|
|
780
|
|
|
// Get pageIDs data from the `page` table |
781
|
|
|
$res = $db->select( 'page', $this->getPageTableFields(), $set, |
|
|
|
|
782
|
|
|
__METHOD__ ); |
783
|
|
|
|
784
|
|
|
// Hack: get the ns:titles stored in [ ns => [ titles ] ] format |
785
|
|
|
$this->initFromQueryResult( $res, $linkBatch->data, true ); // process Titles |
|
|
|
|
786
|
|
|
|
787
|
|
|
// Resolve any found redirects |
788
|
|
|
$this->resolvePendingRedirects(); |
789
|
|
|
} |
790
|
|
|
|
791
|
|
|
/** |
792
|
|
|
* Does the same as initFromTitles(), but is based on page IDs instead |
793
|
|
|
* @param array $pageids Array of page IDs |
794
|
|
|
*/ |
795
|
|
|
private function initFromPageIds( $pageids ) { |
796
|
|
|
if ( !$pageids ) { |
797
|
|
|
return; |
798
|
|
|
} |
799
|
|
|
|
800
|
|
|
$pageids = array_map( 'intval', $pageids ); // paranoia |
801
|
|
|
$remaining = array_flip( $pageids ); |
802
|
|
|
|
803
|
|
|
$pageids = self::getPositiveIntegers( $pageids ); |
804
|
|
|
|
805
|
|
|
$res = null; |
806
|
|
|
if ( !empty( $pageids ) ) { |
807
|
|
|
$set = [ |
808
|
|
|
'page_id' => $pageids |
809
|
|
|
]; |
810
|
|
|
$db = $this->getDB(); |
811
|
|
|
|
812
|
|
|
// Get pageIDs data from the `page` table |
813
|
|
|
$res = $db->select( 'page', $this->getPageTableFields(), $set, |
814
|
|
|
__METHOD__ ); |
815
|
|
|
} |
816
|
|
|
|
817
|
|
|
$this->initFromQueryResult( $res, $remaining, false ); // process PageIDs |
|
|
|
|
818
|
|
|
|
819
|
|
|
// Resolve any found redirects |
820
|
|
|
$this->resolvePendingRedirects(); |
821
|
|
|
} |
822
|
|
|
|
823
|
|
|
/** |
824
|
|
|
* Iterate through the result of the query on 'page' table, |
825
|
|
|
* and for each row create and store title object and save any extra fields requested. |
826
|
|
|
* @param ResultWrapper $res DB Query result |
827
|
|
|
* @param array $remaining Array of either pageID or ns/title elements (optional). |
828
|
|
|
* If given, any missing items will go to $mMissingPageIDs and $mMissingTitles |
829
|
|
|
* @param bool $processTitles Must be provided together with $remaining. |
830
|
|
|
* If true, treat $remaining as an array of [ns][title] |
831
|
|
|
* If false, treat it as an array of [pageIDs] |
832
|
|
|
*/ |
833
|
|
|
private function initFromQueryResult( $res, &$remaining = null, $processTitles = null ) { |
834
|
|
|
if ( !is_null( $remaining ) && is_null( $processTitles ) ) { |
835
|
|
|
ApiBase::dieDebug( __METHOD__, 'Missing $processTitles parameter when $remaining is provided' ); |
836
|
|
|
} |
837
|
|
|
|
838
|
|
|
$usernames = []; |
839
|
|
|
if ( $res ) { |
840
|
|
|
foreach ( $res as $row ) { |
841
|
|
|
$pageId = intval( $row->page_id ); |
842
|
|
|
|
843
|
|
|
// Remove found page from the list of remaining items |
844
|
|
|
if ( isset( $remaining ) ) { |
845
|
|
|
if ( $processTitles ) { |
846
|
|
|
unset( $remaining[$row->page_namespace][$row->page_title] ); |
847
|
|
|
} else { |
848
|
|
|
unset( $remaining[$pageId] ); |
849
|
|
|
} |
850
|
|
|
} |
851
|
|
|
|
852
|
|
|
// Store any extra fields requested by modules |
853
|
|
|
$this->processDbRow( $row ); |
854
|
|
|
|
855
|
|
|
// Need gender information |
856
|
|
|
if ( MWNamespace::hasGenderDistinction( $row->page_namespace ) ) { |
857
|
|
|
$usernames[] = $row->page_title; |
858
|
|
|
} |
859
|
|
|
} |
860
|
|
|
} |
861
|
|
|
|
862
|
|
|
if ( isset( $remaining ) ) { |
863
|
|
|
// Any items left in the $remaining list are added as missing |
864
|
|
|
if ( $processTitles ) { |
865
|
|
|
// The remaining titles in $remaining are non-existent pages |
866
|
|
|
foreach ( $remaining as $ns => $dbkeys ) { |
867
|
|
|
foreach ( array_keys( $dbkeys ) as $dbkey ) { |
868
|
|
|
$title = Title::makeTitle( $ns, $dbkey ); |
869
|
|
|
$this->mAllPages[$ns][$dbkey] = $this->mFakePageId; |
870
|
|
|
$this->mMissingPages[$ns][$dbkey] = $this->mFakePageId; |
871
|
|
|
$this->mGoodAndMissingPages[$ns][$dbkey] = $this->mFakePageId; |
872
|
|
|
$this->mMissingTitles[$this->mFakePageId] = $title; |
873
|
|
|
$this->mFakePageId--; |
874
|
|
|
$this->mTitles[] = $title; |
875
|
|
|
|
876
|
|
|
// need gender information |
877
|
|
|
if ( MWNamespace::hasGenderDistinction( $ns ) ) { |
878
|
|
|
$usernames[] = $dbkey; |
879
|
|
|
} |
880
|
|
|
} |
881
|
|
|
} |
882
|
|
|
} else { |
883
|
|
|
// The remaining pageids do not exist |
884
|
|
|
if ( !$this->mMissingPageIDs ) { |
885
|
|
|
$this->mMissingPageIDs = array_keys( $remaining ); |
886
|
|
|
} else { |
887
|
|
|
$this->mMissingPageIDs = array_merge( $this->mMissingPageIDs, array_keys( $remaining ) ); |
888
|
|
|
} |
889
|
|
|
} |
890
|
|
|
} |
891
|
|
|
|
892
|
|
|
// Get gender information |
893
|
|
|
$genderCache = GenderCache::singleton(); |
894
|
|
|
$genderCache->doQuery( $usernames, __METHOD__ ); |
895
|
|
|
} |
896
|
|
|
|
897
|
|
|
/** |
898
|
|
|
* Does the same as initFromTitles(), but is based on revision IDs |
899
|
|
|
* instead |
900
|
|
|
* @param array $revids Array of revision IDs |
901
|
|
|
*/ |
902
|
|
|
private function initFromRevIDs( $revids ) { |
903
|
|
|
if ( !$revids ) { |
904
|
|
|
return; |
905
|
|
|
} |
906
|
|
|
|
907
|
|
|
$revids = array_map( 'intval', $revids ); // paranoia |
908
|
|
|
$db = $this->getDB(); |
909
|
|
|
$pageids = []; |
910
|
|
|
$remaining = array_flip( $revids ); |
911
|
|
|
|
912
|
|
|
$revids = self::getPositiveIntegers( $revids ); |
913
|
|
|
|
914
|
|
|
if ( !empty( $revids ) ) { |
915
|
|
|
$tables = [ 'revision', 'page' ]; |
916
|
|
|
$fields = [ 'rev_id', 'rev_page' ]; |
917
|
|
|
$where = [ 'rev_id' => $revids, 'rev_page = page_id' ]; |
918
|
|
|
|
919
|
|
|
// Get pageIDs data from the `page` table |
920
|
|
|
$res = $db->select( $tables, $fields, $where, __METHOD__ ); |
921
|
|
|
foreach ( $res as $row ) { |
|
|
|
|
922
|
|
|
$revid = intval( $row->rev_id ); |
923
|
|
|
$pageid = intval( $row->rev_page ); |
924
|
|
|
$this->mGoodRevIDs[$revid] = $pageid; |
925
|
|
|
$this->mLiveRevIDs[$revid] = $pageid; |
926
|
|
|
$pageids[$pageid] = ''; |
927
|
|
|
unset( $remaining[$revid] ); |
928
|
|
|
} |
929
|
|
|
} |
930
|
|
|
|
931
|
|
|
$this->mMissingRevIDs = array_keys( $remaining ); |
932
|
|
|
|
933
|
|
|
// Populate all the page information |
934
|
|
|
$this->initFromPageIds( array_keys( $pageids ) ); |
935
|
|
|
|
936
|
|
|
// If the user can see deleted revisions, pull out the corresponding |
937
|
|
|
// titles from the archive table and include them too. We ignore |
938
|
|
|
// ar_page_id because deleted revisions are tied by title, not page_id. |
939
|
|
|
if ( !empty( $this->mMissingRevIDs ) && $this->getUser()->isAllowed( 'deletedhistory' ) ) { |
940
|
|
|
$remaining = array_flip( $this->mMissingRevIDs ); |
941
|
|
|
$tables = [ 'archive' ]; |
942
|
|
|
$fields = [ 'ar_rev_id', 'ar_namespace', 'ar_title' ]; |
943
|
|
|
$where = [ 'ar_rev_id' => $this->mMissingRevIDs ]; |
944
|
|
|
|
945
|
|
|
$res = $db->select( $tables, $fields, $where, __METHOD__ ); |
946
|
|
|
$titles = []; |
947
|
|
|
foreach ( $res as $row ) { |
|
|
|
|
948
|
|
|
$revid = intval( $row->ar_rev_id ); |
949
|
|
|
$titles[$revid] = Title::makeTitle( $row->ar_namespace, $row->ar_title ); |
950
|
|
|
unset( $remaining[$revid] ); |
951
|
|
|
} |
952
|
|
|
|
953
|
|
|
$this->initFromTitles( $titles ); |
954
|
|
|
|
955
|
|
|
foreach ( $titles as $revid => $title ) { |
956
|
|
|
$ns = $title->getNamespace(); |
957
|
|
|
$dbkey = $title->getDBkey(); |
958
|
|
|
|
959
|
|
|
// Handle converted titles |
960
|
|
|
if ( !isset( $this->mAllPages[$ns][$dbkey] ) && |
961
|
|
|
isset( $this->mConvertedTitles[$title->getPrefixedText()] ) |
962
|
|
|
) { |
963
|
|
|
$title = Title::newFromText( $this->mConvertedTitles[$title->getPrefixedText()] ); |
964
|
|
|
$ns = $title->getNamespace(); |
965
|
|
|
$dbkey = $title->getDBkey(); |
966
|
|
|
} |
967
|
|
|
|
968
|
|
|
if ( isset( $this->mAllPages[$ns][$dbkey] ) ) { |
969
|
|
|
$this->mGoodRevIDs[$revid] = $this->mAllPages[$ns][$dbkey]; |
970
|
|
|
$this->mDeletedRevIDs[$revid] = $this->mAllPages[$ns][$dbkey]; |
971
|
|
|
} else { |
972
|
|
|
$remaining[$revid] = true; |
973
|
|
|
} |
974
|
|
|
} |
975
|
|
|
|
976
|
|
|
$this->mMissingRevIDs = array_keys( $remaining ); |
977
|
|
|
} |
978
|
|
|
} |
979
|
|
|
|
980
|
|
|
/** |
981
|
|
|
* Resolve any redirects in the result if redirect resolution was |
982
|
|
|
* requested. This function is called repeatedly until all redirects |
983
|
|
|
* have been resolved. |
984
|
|
|
*/ |
985
|
|
|
private function resolvePendingRedirects() { |
986
|
|
|
if ( $this->mResolveRedirects ) { |
987
|
|
|
$db = $this->getDB(); |
988
|
|
|
$pageFlds = $this->getPageTableFields(); |
989
|
|
|
|
990
|
|
|
// Repeat until all redirects have been resolved |
991
|
|
|
// The infinite loop is prevented by keeping all known pages in $this->mAllPages |
992
|
|
|
while ( $this->mPendingRedirectIDs ) { |
993
|
|
|
// Resolve redirects by querying the pagelinks table, and repeat the process |
994
|
|
|
// Create a new linkBatch object for the next pass |
995
|
|
|
$linkBatch = $this->getRedirectTargets(); |
996
|
|
|
|
997
|
|
|
if ( $linkBatch->isEmpty() ) { |
998
|
|
|
break; |
999
|
|
|
} |
1000
|
|
|
|
1001
|
|
|
$set = $linkBatch->constructSet( 'page', $db ); |
1002
|
|
|
if ( $set === false ) { |
1003
|
|
|
break; |
1004
|
|
|
} |
1005
|
|
|
|
1006
|
|
|
// Get pageIDs data from the `page` table |
1007
|
|
|
$res = $db->select( 'page', $pageFlds, $set, __METHOD__ ); |
|
|
|
|
1008
|
|
|
|
1009
|
|
|
// Hack: get the ns:titles stored in [ns => array(titles)] format |
1010
|
|
|
$this->initFromQueryResult( $res, $linkBatch->data, true ); |
|
|
|
|
1011
|
|
|
} |
1012
|
|
|
} |
1013
|
|
|
} |
1014
|
|
|
|
1015
|
|
|
/** |
1016
|
|
|
* Get the targets of the pending redirects from the database |
1017
|
|
|
* |
1018
|
|
|
* Also creates entries in the redirect table for redirects that don't |
1019
|
|
|
* have one. |
1020
|
|
|
* @return LinkBatch |
1021
|
|
|
*/ |
1022
|
|
|
private function getRedirectTargets() { |
1023
|
|
|
$lb = new LinkBatch(); |
1024
|
|
|
$db = $this->getDB(); |
1025
|
|
|
|
1026
|
|
|
$res = $db->select( |
1027
|
|
|
'redirect', |
1028
|
|
|
[ |
1029
|
|
|
'rd_from', |
1030
|
|
|
'rd_namespace', |
1031
|
|
|
'rd_fragment', |
1032
|
|
|
'rd_interwiki', |
1033
|
|
|
'rd_title' |
1034
|
|
|
], [ 'rd_from' => array_keys( $this->mPendingRedirectIDs ) ], |
1035
|
|
|
__METHOD__ |
1036
|
|
|
); |
1037
|
|
|
foreach ( $res as $row ) { |
|
|
|
|
1038
|
|
|
$rdfrom = intval( $row->rd_from ); |
1039
|
|
|
$from = $this->mPendingRedirectIDs[$rdfrom]->getPrefixedText(); |
1040
|
|
|
$to = Title::makeTitle( |
1041
|
|
|
$row->rd_namespace, |
1042
|
|
|
$row->rd_title, |
1043
|
|
|
$row->rd_fragment, |
1044
|
|
|
$row->rd_interwiki |
1045
|
|
|
); |
1046
|
|
|
$this->mResolvedRedirectTitles[$from] = $this->mPendingRedirectIDs[$rdfrom]; |
1047
|
|
|
unset( $this->mPendingRedirectIDs[$rdfrom] ); |
1048
|
|
|
if ( $to->isExternal() ) { |
1049
|
|
|
$this->mInterwikiTitles[$to->getPrefixedText()] = $to->getInterwiki(); |
1050
|
|
|
} elseif ( !isset( $this->mAllPages[$row->rd_namespace][$row->rd_title] ) ) { |
1051
|
|
|
$lb->add( $row->rd_namespace, $row->rd_title ); |
1052
|
|
|
} |
1053
|
|
|
$this->mRedirectTitles[$from] = $to; |
1054
|
|
|
} |
1055
|
|
|
|
1056
|
|
|
if ( $this->mPendingRedirectIDs ) { |
1057
|
|
|
// We found pages that aren't in the redirect table |
1058
|
|
|
// Add them |
1059
|
|
|
foreach ( $this->mPendingRedirectIDs as $id => $title ) { |
1060
|
|
|
$page = WikiPage::factory( $title ); |
1061
|
|
|
$rt = $page->insertRedirect(); |
|
|
|
|
1062
|
|
|
if ( !$rt ) { |
1063
|
|
|
// What the hell. Let's just ignore this |
1064
|
|
|
continue; |
1065
|
|
|
} |
1066
|
|
|
$lb->addObj( $rt ); |
1067
|
|
|
$from = $title->getPrefixedText(); |
1068
|
|
|
$this->mResolvedRedirectTitles[$from] = $title; |
1069
|
|
|
$this->mRedirectTitles[$from] = $rt; |
1070
|
|
|
unset( $this->mPendingRedirectIDs[$id] ); |
1071
|
|
|
} |
1072
|
|
|
} |
1073
|
|
|
|
1074
|
|
|
return $lb; |
1075
|
|
|
} |
1076
|
|
|
|
1077
|
|
|
/** |
1078
|
|
|
* Get the cache mode for the data generated by this module. |
1079
|
|
|
* All PageSet users should take into account whether this returns a more-restrictive |
1080
|
|
|
* cache mode than the using module itself. For possible return values and other |
1081
|
|
|
* details about cache modes, see ApiMain::setCacheMode() |
1082
|
|
|
* |
1083
|
|
|
* Public caching will only be allowed if *all* the modules that supply |
1084
|
|
|
* data for a given request return a cache mode of public. |
1085
|
|
|
* |
1086
|
|
|
* @param array|null $params |
1087
|
|
|
* @return string |
1088
|
|
|
* @since 1.21 |
1089
|
|
|
*/ |
1090
|
|
|
public function getCacheMode( $params = null ) { |
1091
|
|
|
return $this->mCacheMode; |
1092
|
|
|
} |
1093
|
|
|
|
1094
|
|
|
/** |
1095
|
|
|
* Given an array of title strings, convert them into Title objects. |
1096
|
|
|
* Alternatively, an array of Title objects may be given. |
1097
|
|
|
* This method validates access rights for the title, |
1098
|
|
|
* and appends normalization values to the output. |
1099
|
|
|
* |
1100
|
|
|
* @param array $titles Array of Title objects or strings |
1101
|
|
|
* @return LinkBatch |
1102
|
|
|
*/ |
1103
|
|
|
private function processTitlesArray( $titles ) { |
1104
|
|
|
$usernames = []; |
1105
|
|
|
$linkBatch = new LinkBatch(); |
1106
|
|
|
|
1107
|
|
|
foreach ( $titles as $title ) { |
1108
|
|
|
if ( is_string( $title ) ) { |
1109
|
|
|
try { |
1110
|
|
|
$titleObj = Title::newFromTextThrow( $title, $this->mDefaultNamespace ); |
1111
|
|
|
} catch ( MalformedTitleException $ex ) { |
1112
|
|
|
// Handle invalid titles gracefully |
1113
|
|
|
$this->mAllPages[0][$title] = $this->mFakePageId; |
1114
|
|
|
$this->mInvalidTitles[$this->mFakePageId] = [ |
1115
|
|
|
'title' => $title, |
1116
|
|
|
'invalidreason' => $ex->getMessage(), |
1117
|
|
|
]; |
1118
|
|
|
$this->mFakePageId--; |
1119
|
|
|
continue; // There's nothing else we can do |
1120
|
|
|
} |
1121
|
|
|
} else { |
1122
|
|
|
$titleObj = $title; |
1123
|
|
|
} |
1124
|
|
|
$unconvertedTitle = $titleObj->getPrefixedText(); |
1125
|
|
|
$titleWasConverted = false; |
1126
|
|
|
if ( $titleObj->isExternal() ) { |
1127
|
|
|
// This title is an interwiki link. |
1128
|
|
|
$this->mInterwikiTitles[$unconvertedTitle] = $titleObj->getInterwiki(); |
1129
|
|
|
} else { |
1130
|
|
|
// Variants checking |
1131
|
|
|
global $wgContLang; |
1132
|
|
|
if ( $this->mConvertTitles && |
1133
|
|
|
count( $wgContLang->getVariants() ) > 1 && |
1134
|
|
|
!$titleObj->exists() |
1135
|
|
|
) { |
1136
|
|
|
// Language::findVariantLink will modify titleText and titleObj into |
1137
|
|
|
// the canonical variant if possible |
1138
|
|
|
$titleText = is_string( $title ) ? $title : $titleObj->getPrefixedText(); |
1139
|
|
|
$wgContLang->findVariantLink( $titleText, $titleObj ); |
1140
|
|
|
$titleWasConverted = $unconvertedTitle !== $titleObj->getPrefixedText(); |
1141
|
|
|
} |
1142
|
|
|
|
1143
|
|
|
if ( $titleObj->getNamespace() < 0 ) { |
1144
|
|
|
// Handle Special and Media pages |
1145
|
|
|
$titleObj = $titleObj->fixSpecialName(); |
1146
|
|
|
$this->mSpecialTitles[$this->mFakePageId] = $titleObj; |
1147
|
|
|
$this->mFakePageId--; |
1148
|
|
|
} else { |
1149
|
|
|
// Regular page |
1150
|
|
|
$linkBatch->addObj( $titleObj ); |
1151
|
|
|
} |
1152
|
|
|
} |
1153
|
|
|
|
1154
|
|
|
// Make sure we remember the original title that was |
1155
|
|
|
// given to us. This way the caller can correlate new |
1156
|
|
|
// titles with the originally requested when e.g. the |
1157
|
|
|
// namespace is localized or the capitalization is |
1158
|
|
|
// different |
1159
|
|
|
if ( $titleWasConverted ) { |
1160
|
|
|
$this->mConvertedTitles[$unconvertedTitle] = $titleObj->getPrefixedText(); |
1161
|
|
|
// In this case the page can't be Special. |
1162
|
|
|
if ( is_string( $title ) && $title !== $unconvertedTitle ) { |
1163
|
|
|
$this->mNormalizedTitles[$title] = $unconvertedTitle; |
1164
|
|
|
} |
1165
|
|
|
} elseif ( is_string( $title ) && $title !== $titleObj->getPrefixedText() ) { |
1166
|
|
|
$this->mNormalizedTitles[$title] = $titleObj->getPrefixedText(); |
1167
|
|
|
} |
1168
|
|
|
|
1169
|
|
|
// Need gender information |
1170
|
|
|
if ( MWNamespace::hasGenderDistinction( $titleObj->getNamespace() ) ) { |
1171
|
|
|
$usernames[] = $titleObj->getText(); |
1172
|
|
|
} |
1173
|
|
|
} |
1174
|
|
|
// Get gender information |
1175
|
|
|
$genderCache = GenderCache::singleton(); |
1176
|
|
|
$genderCache->doQuery( $usernames, __METHOD__ ); |
1177
|
|
|
|
1178
|
|
|
return $linkBatch; |
1179
|
|
|
} |
1180
|
|
|
|
1181
|
|
|
/** |
1182
|
|
|
* Set data for a title. |
1183
|
|
|
* |
1184
|
|
|
* This data may be extracted into an ApiResult using |
1185
|
|
|
* self::populateGeneratorData. This should generally be limited to |
1186
|
|
|
* data that is likely to be particularly useful to end users rather than |
1187
|
|
|
* just being a dump of everything returned in non-generator mode. |
1188
|
|
|
* |
1189
|
|
|
* Redirects here will *not* be followed, even if 'redirects' was |
1190
|
|
|
* specified, since in the case of multiple redirects we can't know which |
1191
|
|
|
* source's data to use on the target. |
1192
|
|
|
* |
1193
|
|
|
* @param Title $title |
1194
|
|
|
* @param array $data |
1195
|
|
|
*/ |
1196
|
|
|
public function setGeneratorData( Title $title, array $data ) { |
1197
|
|
|
$ns = $title->getNamespace(); |
1198
|
|
|
$dbkey = $title->getDBkey(); |
1199
|
|
|
$this->mGeneratorData[$ns][$dbkey] = $data; |
1200
|
|
|
} |
1201
|
|
|
|
1202
|
|
|
/** |
1203
|
|
|
* Controls how generator data about a redirect source is merged into |
1204
|
|
|
* the generator data for the redirect target. When not set no data |
1205
|
|
|
* is merged. Note that if multiple titles redirect to the same target |
1206
|
|
|
* the order of operations is undefined. |
1207
|
|
|
* |
1208
|
|
|
* Example to include generated data from redirect in target, prefering |
1209
|
|
|
* the data generated for the destination when there is a collision: |
1210
|
|
|
* @code |
1211
|
|
|
* $pageSet->setRedirectMergePolicy( function( array $current, array $new ) { |
1212
|
|
|
* return $current + $new; |
1213
|
|
|
* } ); |
1214
|
|
|
* @endcode |
1215
|
|
|
* |
1216
|
|
|
* @param callable|null $callable Recieves two array arguments, first the |
1217
|
|
|
* generator data for the redirect target and second the generator data |
1218
|
|
|
* for the redirect source. Returns the resulting generator data to use |
1219
|
|
|
* for the redirect target. |
1220
|
|
|
*/ |
1221
|
|
|
public function setRedirectMergePolicy( $callable ) { |
1222
|
|
|
$this->mRedirectMergePolicy = $callable; |
1223
|
|
|
} |
1224
|
|
|
|
1225
|
|
|
/** |
1226
|
|
|
* Populate the generator data for all titles in the result |
1227
|
|
|
* |
1228
|
|
|
* The page data may be inserted into an ApiResult object or into an |
1229
|
|
|
* associative array. The $path parameter specifies the path within the |
1230
|
|
|
* ApiResult or array to find the "pages" node. |
1231
|
|
|
* |
1232
|
|
|
* The "pages" node itself must be an associative array mapping the page ID |
1233
|
|
|
* or fake page ID values returned by this pageset (see |
1234
|
|
|
* self::getAllTitlesByNamespace() and self::getSpecialTitles()) to |
1235
|
|
|
* associative arrays of page data. Each of those subarrays will have the |
1236
|
|
|
* data from self::setGeneratorData() merged in. |
1237
|
|
|
* |
1238
|
|
|
* Data that was set by self::setGeneratorData() for pages not in the |
1239
|
|
|
* "pages" node will be ignored. |
1240
|
|
|
* |
1241
|
|
|
* @param ApiResult|array &$result |
1242
|
|
|
* @param array $path |
1243
|
|
|
* @return bool Whether the data fit |
1244
|
|
|
*/ |
1245
|
|
|
public function populateGeneratorData( &$result, array $path = [] ) { |
1246
|
|
|
if ( $result instanceof ApiResult ) { |
1247
|
|
|
$data = $result->getResultData( $path ); |
1248
|
|
|
if ( $data === null ) { |
1249
|
|
|
return true; |
1250
|
|
|
} |
1251
|
|
|
} else { |
1252
|
|
|
$data = &$result; |
1253
|
|
|
foreach ( $path as $key ) { |
1254
|
|
|
if ( !isset( $data[$key] ) ) { |
1255
|
|
|
// Path isn't in $result, so nothing to add, so everything |
1256
|
|
|
// "fits" |
1257
|
|
|
return true; |
1258
|
|
|
} |
1259
|
|
|
$data = &$data[$key]; |
1260
|
|
|
} |
1261
|
|
|
} |
1262
|
|
|
foreach ( $this->mGeneratorData as $ns => $dbkeys ) { |
1263
|
|
|
if ( $ns === -1 ) { |
1264
|
|
|
$pages = []; |
1265
|
|
|
foreach ( $this->mSpecialTitles as $id => $title ) { |
1266
|
|
|
$pages[$title->getDBkey()] = $id; |
1267
|
|
|
} |
1268
|
|
|
} else { |
1269
|
|
|
if ( !isset( $this->mAllPages[$ns] ) ) { |
1270
|
|
|
// No known titles in the whole namespace. Skip it. |
1271
|
|
|
continue; |
1272
|
|
|
} |
1273
|
|
|
$pages = $this->mAllPages[$ns]; |
1274
|
|
|
} |
1275
|
|
|
foreach ( $dbkeys as $dbkey => $genData ) { |
1276
|
|
|
if ( !isset( $pages[$dbkey] ) ) { |
1277
|
|
|
// Unknown title. Forget it. |
1278
|
|
|
continue; |
1279
|
|
|
} |
1280
|
|
|
$pageId = $pages[$dbkey]; |
1281
|
|
|
if ( !isset( $data[$pageId] ) ) { |
1282
|
|
|
// $pageId didn't make it into the result. Ignore it. |
1283
|
|
|
continue; |
1284
|
|
|
} |
1285
|
|
|
|
1286
|
|
|
if ( $result instanceof ApiResult ) { |
1287
|
|
|
$path2 = array_merge( $path, [ $pageId ] ); |
1288
|
|
|
foreach ( $genData as $key => $value ) { |
1289
|
|
|
if ( !$result->addValue( $path2, $key, $value ) ) { |
1290
|
|
|
return false; |
1291
|
|
|
} |
1292
|
|
|
} |
1293
|
|
|
} else { |
1294
|
|
|
$data[$pageId] = array_merge( $data[$pageId], $genData ); |
1295
|
|
|
} |
1296
|
|
|
} |
1297
|
|
|
} |
1298
|
|
|
|
1299
|
|
|
// Merge data generated about redirect titles into the redirect destination |
1300
|
|
|
if ( $this->mRedirectMergePolicy ) { |
1301
|
|
|
foreach ( $this->mResolvedRedirectTitles as $titleFrom ) { |
1302
|
|
|
$dest = $titleFrom; |
1303
|
|
|
while ( isset( $this->mRedirectTitles[$dest->getPrefixedText()] ) ) { |
1304
|
|
|
$dest = $this->mRedirectTitles[$dest->getPrefixedText()]; |
1305
|
|
|
} |
1306
|
|
|
$fromNs = $titleFrom->getNamespace(); |
1307
|
|
|
$fromDBkey = $titleFrom->getDBkey(); |
1308
|
|
|
$toPageId = $dest->getArticleID(); |
1309
|
|
|
if ( isset( $data[$toPageId] ) && |
1310
|
|
|
isset( $this->mGeneratorData[$fromNs][$fromDBkey] ) |
1311
|
|
|
) { |
1312
|
|
|
// It is necesary to set both $data and add to $result, if an ApiResult, |
1313
|
|
|
// to ensure multiple redirects to the same destination are all merged. |
1314
|
|
|
$data[$toPageId] = call_user_func( |
1315
|
|
|
$this->mRedirectMergePolicy, |
1316
|
|
|
$data[$toPageId], |
1317
|
|
|
$this->mGeneratorData[$fromNs][$fromDBkey] |
1318
|
|
|
); |
1319
|
|
|
if ( $result instanceof ApiResult ) { |
1320
|
|
|
if ( !$result->addValue( $path, $toPageId, $data[$toPageId], ApiResult::OVERRIDE ) ) { |
1321
|
|
|
return false; |
1322
|
|
|
} |
1323
|
|
|
} |
1324
|
|
|
} |
1325
|
|
|
} |
1326
|
|
|
} |
1327
|
|
|
|
1328
|
|
|
return true; |
1329
|
|
|
} |
1330
|
|
|
|
1331
|
|
|
/** |
1332
|
|
|
* Get the database connection (read-only) |
1333
|
|
|
* @return DatabaseBase |
1334
|
|
|
*/ |
1335
|
|
|
protected function getDB() { |
1336
|
|
|
return $this->mDbSource->getDB(); |
1337
|
|
|
} |
1338
|
|
|
|
1339
|
|
|
/** |
1340
|
|
|
* Returns the input array of integers with all values < 0 removed |
1341
|
|
|
* |
1342
|
|
|
* @param array $array |
1343
|
|
|
* @return array |
1344
|
|
|
*/ |
1345
|
|
|
private static function getPositiveIntegers( $array ) { |
1346
|
|
|
// bug 25734 API: possible issue with revids validation |
1347
|
|
|
// It seems with a load of revision rows, MySQL gets upset |
1348
|
|
|
// Remove any < 0 integers, as they can't be valid |
1349
|
|
|
foreach ( $array as $i => $int ) { |
1350
|
|
|
if ( $int < 0 ) { |
1351
|
|
|
unset( $array[$i] ); |
1352
|
|
|
} |
1353
|
|
|
} |
1354
|
|
|
|
1355
|
|
|
return $array; |
1356
|
|
|
} |
1357
|
|
|
|
1358
|
|
|
public function getAllowedParams( $flags = 0 ) { |
1359
|
|
|
$result = [ |
1360
|
|
|
'titles' => [ |
1361
|
|
|
ApiBase::PARAM_ISMULTI => true, |
1362
|
|
|
ApiBase::PARAM_HELP_MSG => 'api-pageset-param-titles', |
1363
|
|
|
], |
1364
|
|
|
'pageids' => [ |
1365
|
|
|
ApiBase::PARAM_TYPE => 'integer', |
1366
|
|
|
ApiBase::PARAM_ISMULTI => true, |
1367
|
|
|
ApiBase::PARAM_HELP_MSG => 'api-pageset-param-pageids', |
1368
|
|
|
], |
1369
|
|
|
'revids' => [ |
1370
|
|
|
ApiBase::PARAM_TYPE => 'integer', |
1371
|
|
|
ApiBase::PARAM_ISMULTI => true, |
1372
|
|
|
ApiBase::PARAM_HELP_MSG => 'api-pageset-param-revids', |
1373
|
|
|
], |
1374
|
|
|
'generator' => [ |
1375
|
|
|
ApiBase::PARAM_TYPE => null, |
1376
|
|
|
ApiBase::PARAM_HELP_MSG => 'api-pageset-param-generator', |
1377
|
|
|
ApiBase::PARAM_SUBMODULE_PARAM_PREFIX => 'g', |
1378
|
|
|
], |
1379
|
|
|
'redirects' => [ |
1380
|
|
|
ApiBase::PARAM_DFLT => false, |
1381
|
|
|
ApiBase::PARAM_HELP_MSG => $this->mAllowGenerator |
1382
|
|
|
? 'api-pageset-param-redirects-generator' |
1383
|
|
|
: 'api-pageset-param-redirects-nogenerator', |
1384
|
|
|
], |
1385
|
|
|
'converttitles' => [ |
1386
|
|
|
ApiBase::PARAM_DFLT => false, |
1387
|
|
|
ApiBase::PARAM_HELP_MSG => [ |
1388
|
|
|
'api-pageset-param-converttitles', |
1389
|
|
|
new DeferredStringifier( |
1390
|
|
|
function ( IContextSource $context ) { |
1391
|
|
|
return $context->getLanguage() |
1392
|
|
|
->commaList( LanguageConverter::$languagesWithVariants ); |
1393
|
|
|
}, |
1394
|
|
|
$this |
1395
|
|
|
) |
1396
|
|
|
], |
1397
|
|
|
], |
1398
|
|
|
]; |
1399
|
|
|
|
1400
|
|
|
if ( !$this->mAllowGenerator ) { |
1401
|
|
|
unset( $result['generator'] ); |
1402
|
|
|
} elseif ( $flags & ApiBase::GET_VALUES_FOR_HELP ) { |
1403
|
|
|
$result['generator'][ApiBase::PARAM_TYPE] = 'submodule'; |
1404
|
|
|
$result['generator'][ApiBase::PARAM_SUBMODULE_MAP] = $this->getGenerators(); |
1405
|
|
|
} |
1406
|
|
|
|
1407
|
|
|
return $result; |
1408
|
|
|
} |
1409
|
|
|
|
1410
|
|
|
protected function handleParamNormalization( $paramName, $value, $rawValue ) { |
1411
|
|
|
parent::handleParamNormalization( $paramName, $value, $rawValue ); |
1412
|
|
|
|
1413
|
|
|
if ( $paramName === 'titles' ) { |
1414
|
|
|
// For the 'titles' parameter, we want to split it like ApiBase would |
1415
|
|
|
// and add any changed titles to $this->mNormalizedTitles |
1416
|
|
|
$value = $this->explodeMultiValue( $value, self::LIMIT_SML2 + 1 ); |
1417
|
|
|
$l = count( $value ); |
1418
|
|
|
$rawValue = $this->explodeMultiValue( $rawValue, $l ); |
1419
|
|
|
for ( $i = 0; $i < $l; $i++ ) { |
1420
|
|
|
if ( $value[$i] !== $rawValue[$i] ) { |
1421
|
|
|
$this->mNormalizedTitles[$rawValue[$i]] = $value[$i]; |
1422
|
|
|
} |
1423
|
|
|
} |
1424
|
|
|
} |
1425
|
|
|
} |
1426
|
|
|
|
1427
|
|
|
private static $generators = null; |
1428
|
|
|
|
1429
|
|
|
/** |
1430
|
|
|
* Get an array of all available generators |
1431
|
|
|
* @return array |
1432
|
|
|
*/ |
1433
|
|
|
private function getGenerators() { |
1434
|
|
|
if ( self::$generators === null ) { |
1435
|
|
|
$query = $this->mDbSource; |
1436
|
|
|
if ( !( $query instanceof ApiQuery ) ) { |
1437
|
|
|
// If the parent container of this pageset is not ApiQuery, |
1438
|
|
|
// we must create it to get module manager |
1439
|
|
|
$query = $this->getMain()->getModuleManager()->getModule( 'query' ); |
1440
|
|
|
} |
1441
|
|
|
$gens = []; |
1442
|
|
|
$prefix = $query->getModulePath() . '+'; |
1443
|
|
|
$mgr = $query->getModuleManager(); |
1444
|
|
|
foreach ( $mgr->getNamesWithClasses() as $name => $class ) { |
1445
|
|
|
if ( is_subclass_of( $class, 'ApiQueryGeneratorBase' ) ) { |
1446
|
|
|
$gens[$name] = $prefix . $name; |
1447
|
|
|
} |
1448
|
|
|
} |
1449
|
|
|
ksort( $gens ); |
1450
|
|
|
self::$generators = $gens; |
1451
|
|
|
} |
1452
|
|
|
|
1453
|
|
|
return self::$generators; |
1454
|
|
|
} |
1455
|
|
|
} |
1456
|
|
|
|
Unless you are absolutely sure that the expression can never be null because of other conditions, we strongly recommend to add an additional type check to your code: