MediaWiki  master
ApiPageSet.php
Go to the documentation of this file.
1 <?php
25 
40 class ApiPageSet extends ApiBase {
45  const DISABLE_GENERATORS = 1;
46 
47  private $mDbSource;
48  private $mParams;
50  private $mConvertTitles;
52 
53  private $mAllPages = []; // [ns][dbkey] => page_id or negative when missing
54  private $mTitles = [];
55  private $mGoodAndMissingPages = []; // [ns][dbkey] => page_id or negative when missing
56  private $mGoodPages = []; // [ns][dbkey] => page_id
57  private $mGoodTitles = [];
58  private $mMissingPages = []; // [ns][dbkey] => fake page_id
59  private $mMissingTitles = [];
61  private $mInvalidTitles = [];
62  private $mMissingPageIDs = [];
63  private $mRedirectTitles = [];
64  private $mSpecialTitles = [];
65  private $mAllSpecials = []; // separate from mAllPages to avoid breaking getAllTitlesByNamespace()
66  private $mNormalizedTitles = [];
67  private $mInterwikiTitles = [];
69  private $mPendingRedirectIDs = [];
70  private $mPendingRedirectSpecialPages = []; // [dbkey] => [ Title $from, Title $to ]
72  private $mConvertedTitles = [];
73  private $mGoodRevIDs = [];
74  private $mLiveRevIDs = [];
75  private $mDeletedRevIDs = [];
76  private $mMissingRevIDs = [];
77  private $mGeneratorData = []; // [ns][dbkey] => data array
78  private $mFakePageId = -1;
79  private $mCacheMode = 'public';
80  private $mRequestedPageFields = [];
85 
93  private static function addValues( array &$result, $values, $flags = [], $name = null ) {
94  foreach ( $values as $val ) {
95  if ( $val instanceof Title ) {
96  $v = [];
97  ApiQueryBase::addTitleInfo( $v, $val );
98  } elseif ( $name !== null ) {
99  $v = [ $name => $val ];
100  } else {
101  $v = $val;
102  }
103  foreach ( $flags as $flag ) {
104  $v[$flag] = true;
105  }
106  $result[] = $v;
107  }
108  }
109 
117  public function __construct( ApiBase $dbSource, $flags = 0, $defaultNamespace = NS_MAIN ) {
118  parent::__construct( $dbSource->getMain(), $dbSource->getModuleName() );
119  $this->mDbSource = $dbSource;
120  $this->mAllowGenerator = ( $flags & self::DISABLE_GENERATORS ) == 0;
121  $this->mDefaultNamespace = $defaultNamespace;
122 
123  $this->mParams = $this->extractRequestParams();
124  $this->mResolveRedirects = $this->mParams['redirects'];
125  $this->mConvertTitles = $this->mParams['converttitles'];
126  }
127 
132  public function executeDryRun() {
133  $this->executeInternal( true );
134  }
135 
139  public function execute() {
140  $this->executeInternal( false );
141  }
142 
148  private function executeInternal( $isDryRun ) {
149  $generatorName = $this->mAllowGenerator ? $this->mParams['generator'] : null;
150  if ( isset( $generatorName ) ) {
151  $dbSource = $this->mDbSource;
152  if ( !$dbSource instanceof ApiQuery ) {
153  // If the parent container of this pageset is not ApiQuery, we must create it to run generator
154  $dbSource = $this->getMain()->getModuleManager()->getModule( 'query' );
155  }
156  $generator = $dbSource->getModuleManager()->getModule( $generatorName, null, true );
157  if ( $generator === null ) {
158  $this->dieWithError( [ 'apierror-badgenerator-unknown', $generatorName ], 'badgenerator' );
159  }
160  if ( !$generator instanceof ApiQueryGeneratorBase ) {
161  $this->dieWithError( [ 'apierror-badgenerator-notgenerator', $generatorName ], 'badgenerator' );
162  }
163  // Create a temporary pageset to store generator's output,
164  // add any additional fields generator may need, and execute pageset to populate titles/pageids
165  $tmpPageSet = new ApiPageSet( $dbSource, self::DISABLE_GENERATORS );
166  $generator->setGeneratorMode( $tmpPageSet );
167  $this->mCacheMode = $generator->getCacheMode( $generator->extractRequestParams() );
168 
169  if ( !$isDryRun ) {
170  $generator->requestExtraData( $tmpPageSet );
171  }
172  $tmpPageSet->executeInternal( $isDryRun );
173 
174  // populate this pageset with the generator output
175  if ( !$isDryRun ) {
176  $generator->executeGenerator( $this );
177 
178  // Avoid PHP 7.1 warning of passing $this by reference
179  $apiModule = $this;
180  Hooks::run( 'APIQueryGeneratorAfterExecute', [ &$generator, &$apiModule ] );
181  } else {
182  // Prevent warnings from being reported on these parameters
183  $main = $this->getMain();
184  foreach ( $generator->extractRequestParams() as $paramName => $param ) {
185  $main->markParamsUsed( $generator->encodeParamName( $paramName ) );
186  }
187  }
188 
189  if ( !$isDryRun ) {
190  $this->resolvePendingRedirects();
191  }
192  } else {
193  // Only one of the titles/pageids/revids is allowed at the same time
194  $dataSource = null;
195  if ( isset( $this->mParams['titles'] ) ) {
196  $dataSource = 'titles';
197  }
198  if ( isset( $this->mParams['pageids'] ) ) {
199  if ( isset( $dataSource ) ) {
200  $this->dieWithError(
201  [
202  'apierror-invalidparammix-cannotusewith',
203  $this->encodeParamName( 'pageids' ),
204  $this->encodeParamName( $dataSource )
205  ],
206  'multisource'
207  );
208  }
209  $dataSource = 'pageids';
210  }
211  if ( isset( $this->mParams['revids'] ) ) {
212  if ( isset( $dataSource ) ) {
213  $this->dieWithError(
214  [
215  'apierror-invalidparammix-cannotusewith',
216  $this->encodeParamName( 'revids' ),
217  $this->encodeParamName( $dataSource )
218  ],
219  'multisource'
220  );
221  }
222  $dataSource = 'revids';
223  }
224 
225  if ( !$isDryRun ) {
226  // Populate page information with the original user input
227  switch ( $dataSource ) {
228  case 'titles':
229  $this->initFromTitles( $this->mParams['titles'] );
230  break;
231  case 'pageids':
232  $this->initFromPageIds( $this->mParams['pageids'] );
233  break;
234  case 'revids':
235  if ( $this->mResolveRedirects ) {
236  $this->addWarning( 'apiwarn-redirectsandrevids' );
237  }
238  $this->mResolveRedirects = false;
239  $this->initFromRevIDs( $this->mParams['revids'] );
240  break;
241  default:
242  // Do nothing - some queries do not need any of the data sources.
243  break;
244  }
245  }
246  }
247  }
248 
253  public function isResolvingRedirects() {
255  }
256 
265  public function getDataSource() {
266  if ( $this->mAllowGenerator && isset( $this->mParams['generator'] ) ) {
267  return 'generator';
268  }
269  if ( isset( $this->mParams['titles'] ) ) {
270  return 'titles';
271  }
272  if ( isset( $this->mParams['pageids'] ) ) {
273  return 'pageids';
274  }
275  if ( isset( $this->mParams['revids'] ) ) {
276  return 'revids';
277  }
278 
279  return null;
280  }
281 
287  public function requestField( $fieldName ) {
288  $this->mRequestedPageFields[$fieldName] = null;
289  }
290 
297  public function getCustomField( $fieldName ) {
298  return $this->mRequestedPageFields[$fieldName];
299  }
300 
307  public function getPageTableFields() {
308  // Ensure we get minimum required fields
309  // DON'T change this order
310  $pageFlds = [
311  'page_namespace' => null,
312  'page_title' => null,
313  'page_id' => null,
314  ];
315 
316  if ( $this->mResolveRedirects ) {
317  $pageFlds['page_is_redirect'] = null;
318  }
319 
320  if ( $this->getConfig()->get( 'ContentHandlerUseDB' ) ) {
321  $pageFlds['page_content_model'] = null;
322  }
323 
324  if ( $this->getConfig()->get( 'PageLanguageUseDB' ) ) {
325  $pageFlds['page_lang'] = null;
326  }
327 
328  foreach ( LinkCache::getSelectFields() as $field ) {
329  $pageFlds[$field] = null;
330  }
331 
332  $pageFlds = array_merge( $pageFlds, $this->mRequestedPageFields );
333 
334  return array_keys( $pageFlds );
335  }
336 
343  public function getAllTitlesByNamespace() {
344  return $this->mAllPages;
345  }
346 
351  public function getTitles() {
352  return $this->mTitles;
353  }
354 
359  public function getTitleCount() {
360  return count( $this->mTitles );
361  }
362 
367  public function getGoodTitlesByNamespace() {
368  return $this->mGoodPages;
369  }
370 
375  public function getGoodTitles() {
376  return $this->mGoodTitles;
377  }
378 
383  public function getGoodTitleCount() {
384  return count( $this->mGoodTitles );
385  }
386 
392  public function getMissingTitlesByNamespace() {
393  return $this->mMissingPages;
394  }
395 
401  public function getMissingTitles() {
402  return $this->mMissingTitles;
403  }
404 
411  }
412 
417  public function getGoodAndMissingTitles() {
418  return $this->mGoodTitles + $this->mMissingTitles;
419  }
420 
426  public function getInvalidTitlesAndReasons() {
427  return $this->mInvalidTitles;
428  }
429 
434  public function getMissingPageIDs() {
435  return $this->mMissingPageIDs;
436  }
437 
443  public function getRedirectTitles() {
444  return $this->mRedirectTitles;
445  }
446 
454  public function getRedirectTitlesAsResult( $result = null ) {
455  $values = [];
456  foreach ( $this->getRedirectTitles() as $titleStrFrom => $titleTo ) {
457  $r = [
458  'from' => strval( $titleStrFrom ),
459  'to' => $titleTo->getPrefixedText(),
460  ];
461  if ( $titleTo->hasFragment() ) {
462  $r['tofragment'] = $titleTo->getFragment();
463  }
464  if ( $titleTo->isExternal() ) {
465  $r['tointerwiki'] = $titleTo->getInterwiki();
466  }
467  if ( isset( $this->mResolvedRedirectTitles[$titleStrFrom] ) ) {
468  $titleFrom = $this->mResolvedRedirectTitles[$titleStrFrom];
469  $ns = $titleFrom->getNamespace();
470  $dbkey = $titleFrom->getDBkey();
471  if ( isset( $this->mGeneratorData[$ns][$dbkey] ) ) {
472  $r = array_merge( $this->mGeneratorData[$ns][$dbkey], $r );
473  }
474  }
475 
476  $values[] = $r;
477  }
478  if ( !empty( $values ) && $result ) {
479  ApiResult::setIndexedTagName( $values, 'r' );
480  }
481 
482  return $values;
483  }
484 
490  public function getNormalizedTitles() {
492  }
493 
501  public function getNormalizedTitlesAsResult( $result = null ) {
502  $values = [];
503  $contLang = MediaWikiServices::getInstance()->getContentLanguage();
504  foreach ( $this->getNormalizedTitles() as $rawTitleStr => $titleStr ) {
505  $encode = $contLang->normalize( $rawTitleStr ) !== $rawTitleStr;
506  $values[] = [
507  'fromencoded' => $encode,
508  'from' => $encode ? rawurlencode( $rawTitleStr ) : $rawTitleStr,
509  'to' => $titleStr
510  ];
511  }
512  if ( !empty( $values ) && $result ) {
513  ApiResult::setIndexedTagName( $values, 'n' );
514  }
515 
516  return $values;
517  }
518 
524  public function getConvertedTitles() {
526  }
527 
535  public function getConvertedTitlesAsResult( $result = null ) {
536  $values = [];
537  foreach ( $this->getConvertedTitles() as $rawTitleStr => $titleStr ) {
538  $values[] = [
539  'from' => $rawTitleStr,
540  'to' => $titleStr
541  ];
542  }
543  if ( !empty( $values ) && $result ) {
544  ApiResult::setIndexedTagName( $values, 'c' );
545  }
546 
547  return $values;
548  }
549 
555  public function getInterwikiTitles() {
557  }
558 
567  public function getInterwikiTitlesAsResult( $result = null, $iwUrl = false ) {
568  $values = [];
569  foreach ( $this->getInterwikiTitles() as $rawTitleStr => $interwikiStr ) {
570  $item = [
571  'title' => $rawTitleStr,
572  'iw' => $interwikiStr,
573  ];
574  if ( $iwUrl ) {
575  $title = Title::newFromText( $rawTitleStr );
576  $item['url'] = $title->getFullURL( '', false, PROTO_CURRENT );
577  }
578  $values[] = $item;
579  }
580  if ( !empty( $values ) && $result ) {
581  ApiResult::setIndexedTagName( $values, 'i' );
582  }
583 
584  return $values;
585  }
586 
601  public function getInvalidTitlesAndRevisions( $invalidChecks = [ 'invalidTitles',
602  'special', 'missingIds', 'missingRevIds', 'missingTitles', 'interwikiTitles' ]
603  ) {
604  $result = [];
605  if ( in_array( 'invalidTitles', $invalidChecks ) ) {
606  self::addValues( $result, $this->getInvalidTitlesAndReasons(), [ 'invalid' ] );
607  }
608  if ( in_array( 'special', $invalidChecks ) ) {
609  $known = [];
610  $unknown = [];
611  foreach ( $this->getSpecialTitles() as $title ) {
612  if ( $title->isKnown() ) {
613  $known[] = $title;
614  } else {
615  $unknown[] = $title;
616  }
617  }
618  self::addValues( $result, $unknown, [ 'special', 'missing' ] );
619  self::addValues( $result, $known, [ 'special' ] );
620  }
621  if ( in_array( 'missingIds', $invalidChecks ) ) {
622  self::addValues( $result, $this->getMissingPageIDs(), [ 'missing' ], 'pageid' );
623  }
624  if ( in_array( 'missingRevIds', $invalidChecks ) ) {
625  self::addValues( $result, $this->getMissingRevisionIDs(), [ 'missing' ], 'revid' );
626  }
627  if ( in_array( 'missingTitles', $invalidChecks ) ) {
628  $known = [];
629  $unknown = [];
630  foreach ( $this->getMissingTitles() as $title ) {
631  if ( $title->isKnown() ) {
632  $known[] = $title;
633  } else {
634  $unknown[] = $title;
635  }
636  }
637  self::addValues( $result, $unknown, [ 'missing' ] );
638  self::addValues( $result, $known, [ 'missing', 'known' ] );
639  }
640  if ( in_array( 'interwikiTitles', $invalidChecks ) ) {
641  self::addValues( $result, $this->getInterwikiTitlesAsResult() );
642  }
643 
644  return $result;
645  }
646 
651  public function getRevisionIDs() {
652  return $this->mGoodRevIDs;
653  }
654 
659  public function getLiveRevisionIDs() {
660  return $this->mLiveRevIDs;
661  }
662 
667  public function getDeletedRevisionIDs() {
668  return $this->mDeletedRevIDs;
669  }
670 
675  public function getMissingRevisionIDs() {
676  return $this->mMissingRevIDs;
677  }
678 
686  $values = [];
687  foreach ( $this->getMissingRevisionIDs() as $revid ) {
688  $values[$revid] = [
689  'revid' => $revid
690  ];
691  }
692  if ( !empty( $values ) && $result ) {
693  ApiResult::setIndexedTagName( $values, 'rev' );
694  }
695 
696  return $values;
697  }
698 
703  public function getSpecialTitles() {
704  return $this->mSpecialTitles;
705  }
706 
711  public function getRevisionCount() {
712  return count( $this->getRevisionIDs() );
713  }
714 
719  public function populateFromTitles( $titles ) {
720  $this->initFromTitles( $titles );
721  }
722 
727  public function populateFromPageIDs( $pageIDs ) {
728  $this->initFromPageIds( $pageIDs );
729  }
730 
740  public function populateFromQueryResult( $db, $queryResult ) {
741  $this->initFromQueryResult( $queryResult );
742  }
743 
748  public function populateFromRevisionIDs( $revIDs ) {
749  $this->initFromRevIDs( $revIDs );
750  }
751 
756  public function processDbRow( $row ) {
757  // Store Title object in various data structures
758  $title = Title::newFromRow( $row );
759 
760  $linkCache = MediaWikiServices::getInstance()->getLinkCache();
761  $linkCache->addGoodLinkObjFromRow( $title, $row );
762 
763  $pageId = (int)$row->page_id;
764  $this->mAllPages[$row->page_namespace][$row->page_title] = $pageId;
765  $this->mTitles[] = $title;
766 
767  if ( $this->mResolveRedirects && $row->page_is_redirect == '1' ) {
768  $this->mPendingRedirectIDs[$pageId] = $title;
769  } else {
770  $this->mGoodPages[$row->page_namespace][$row->page_title] = $pageId;
771  $this->mGoodAndMissingPages[$row->page_namespace][$row->page_title] = $pageId;
772  $this->mGoodTitles[$pageId] = $title;
773  }
774 
775  foreach ( $this->mRequestedPageFields as $fieldName => &$fieldValues ) {
776  $fieldValues[$pageId] = $row->$fieldName;
777  }
778  }
779 
796  private function initFromTitles( $titles ) {
797  // Get validated and normalized title objects
798  $linkBatch = $this->processTitlesArray( $titles );
799  if ( $linkBatch->isEmpty() ) {
800  // There might be special-page redirects
801  $this->resolvePendingRedirects();
802  return;
803  }
804 
805  $db = $this->getDB();
806  $set = $linkBatch->constructSet( 'page', $db );
807 
808  // Get pageIDs data from the `page` table
809  $res = $db->select( 'page', $this->getPageTableFields(), $set,
810  __METHOD__ );
811 
812  // Hack: get the ns:titles stored in [ ns => [ titles ] ] format
813  $this->initFromQueryResult( $res, $linkBatch->data, true ); // process Titles
814 
815  // Resolve any found redirects
816  $this->resolvePendingRedirects();
817  }
818 
824  private function initFromPageIds( $pageids, $filterIds = true ) {
825  if ( !$pageids ) {
826  return;
827  }
828 
829  $pageids = array_map( 'intval', $pageids ); // paranoia
830  $remaining = array_flip( $pageids );
831 
832  if ( $filterIds ) {
833  $pageids = $this->filterIDs( [ [ 'page', 'page_id' ] ], $pageids );
834  }
835 
836  $res = null;
837  if ( !empty( $pageids ) ) {
838  $set = [
839  'page_id' => $pageids
840  ];
841  $db = $this->getDB();
842 
843  // Get pageIDs data from the `page` table
844  $res = $db->select( 'page', $this->getPageTableFields(), $set,
845  __METHOD__ );
846  }
847 
848  $this->initFromQueryResult( $res, $remaining, false ); // process PageIDs
849 
850  // Resolve any found redirects
851  $this->resolvePendingRedirects();
852  }
853 
864  private function initFromQueryResult( $res, &$remaining = null, $processTitles = null ) {
865  if ( !is_null( $remaining ) && is_null( $processTitles ) ) {
866  ApiBase::dieDebug( __METHOD__, 'Missing $processTitles parameter when $remaining is provided' );
867  }
868 
869  $usernames = [];
870  if ( $res ) {
871  foreach ( $res as $row ) {
872  $pageId = (int)$row->page_id;
873 
874  // Remove found page from the list of remaining items
875  if ( isset( $remaining ) ) {
876  if ( $processTitles ) {
877  unset( $remaining[$row->page_namespace][$row->page_title] );
878  } else {
879  unset( $remaining[$pageId] );
880  }
881  }
882 
883  // Store any extra fields requested by modules
884  $this->processDbRow( $row );
885 
886  // Need gender information
887  if ( MWNamespace::hasGenderDistinction( $row->page_namespace ) ) {
888  $usernames[] = $row->page_title;
889  }
890  }
891  }
892 
893  if ( isset( $remaining ) ) {
894  // Any items left in the $remaining list are added as missing
895  if ( $processTitles ) {
896  // The remaining titles in $remaining are non-existent pages
897  $linkCache = MediaWikiServices::getInstance()->getLinkCache();
898  foreach ( $remaining as $ns => $dbkeys ) {
899  foreach ( array_keys( $dbkeys ) as $dbkey ) {
900  $title = Title::makeTitle( $ns, $dbkey );
901  $linkCache->addBadLinkObj( $title );
902  $this->mAllPages[$ns][$dbkey] = $this->mFakePageId;
903  $this->mMissingPages[$ns][$dbkey] = $this->mFakePageId;
904  $this->mGoodAndMissingPages[$ns][$dbkey] = $this->mFakePageId;
905  $this->mMissingTitles[$this->mFakePageId] = $title;
906  $this->mFakePageId--;
907  $this->mTitles[] = $title;
908 
909  // need gender information
910  if ( MWNamespace::hasGenderDistinction( $ns ) ) {
911  $usernames[] = $dbkey;
912  }
913  }
914  }
915  } else {
916  // The remaining pageids do not exist
917  if ( !$this->mMissingPageIDs ) {
918  $this->mMissingPageIDs = array_keys( $remaining );
919  } else {
920  $this->mMissingPageIDs = array_merge( $this->mMissingPageIDs, array_keys( $remaining ) );
921  }
922  }
923  }
924 
925  // Get gender information
926  $genderCache = MediaWikiServices::getInstance()->getGenderCache();
927  $genderCache->doQuery( $usernames, __METHOD__ );
928  }
929 
935  private function initFromRevIDs( $revids ) {
936  if ( !$revids ) {
937  return;
938  }
939 
940  $revids = array_map( 'intval', $revids ); // paranoia
941  $db = $this->getDB();
942  $pageids = [];
943  $remaining = array_flip( $revids );
944 
945  $revids = $this->filterIDs( [ [ 'revision', 'rev_id' ], [ 'archive', 'ar_rev_id' ] ], $revids );
946  $goodRemaining = array_flip( $revids );
947 
948  if ( $revids ) {
949  $tables = [ 'revision', 'page' ];
950  $fields = [ 'rev_id', 'rev_page' ];
951  $where = [ 'rev_id' => $revids, 'rev_page = page_id' ];
952 
953  // Get pageIDs data from the `page` table
954  $res = $db->select( $tables, $fields, $where, __METHOD__ );
955  foreach ( $res as $row ) {
956  $revid = (int)$row->rev_id;
957  $pageid = (int)$row->rev_page;
958  $this->mGoodRevIDs[$revid] = $pageid;
959  $this->mLiveRevIDs[$revid] = $pageid;
960  $pageids[$pageid] = '';
961  unset( $remaining[$revid] );
962  unset( $goodRemaining[$revid] );
963  }
964  }
965 
966  // Populate all the page information
967  $this->initFromPageIds( array_keys( $pageids ), false );
968 
969  // If the user can see deleted revisions, pull out the corresponding
970  // titles from the archive table and include them too. We ignore
971  // ar_page_id because deleted revisions are tied by title, not page_id.
972  if ( $goodRemaining && $this->getUser()->isAllowed( 'deletedhistory' ) ) {
973  $tables = [ 'archive' ];
974  $fields = [ 'ar_rev_id', 'ar_namespace', 'ar_title' ];
975  $where = [ 'ar_rev_id' => array_keys( $goodRemaining ) ];
976 
977  $res = $db->select( $tables, $fields, $where, __METHOD__ );
978  $titles = [];
979  foreach ( $res as $row ) {
980  $revid = (int)$row->ar_rev_id;
981  $titles[$revid] = Title::makeTitle( $row->ar_namespace, $row->ar_title );
982  unset( $remaining[$revid] );
983  }
984 
985  $this->initFromTitles( $titles );
986 
987  foreach ( $titles as $revid => $title ) {
988  $ns = $title->getNamespace();
989  $dbkey = $title->getDBkey();
990 
991  // Handle converted titles
992  if ( !isset( $this->mAllPages[$ns][$dbkey] ) &&
993  isset( $this->mConvertedTitles[$title->getPrefixedText()] )
994  ) {
995  $title = Title::newFromText( $this->mConvertedTitles[$title->getPrefixedText()] );
996  $ns = $title->getNamespace();
997  $dbkey = $title->getDBkey();
998  }
999 
1000  if ( isset( $this->mAllPages[$ns][$dbkey] ) ) {
1001  $this->mGoodRevIDs[$revid] = $this->mAllPages[$ns][$dbkey];
1002  $this->mDeletedRevIDs[$revid] = $this->mAllPages[$ns][$dbkey];
1003  } else {
1004  $remaining[$revid] = true;
1005  }
1006  }
1007  }
1008 
1009  $this->mMissingRevIDs = array_keys( $remaining );
1010  }
1011 
1017  private function resolvePendingRedirects() {
1018  if ( $this->mResolveRedirects ) {
1019  $db = $this->getDB();
1020  $pageFlds = $this->getPageTableFields();
1021 
1022  // Repeat until all redirects have been resolved
1023  // The infinite loop is prevented by keeping all known pages in $this->mAllPages
1024  while ( $this->mPendingRedirectIDs || $this->mPendingRedirectSpecialPages ) {
1025  // Resolve redirects by querying the pagelinks table, and repeat the process
1026  // Create a new linkBatch object for the next pass
1027  $linkBatch = $this->getRedirectTargets();
1028 
1029  if ( $linkBatch->isEmpty() ) {
1030  break;
1031  }
1032 
1033  $set = $linkBatch->constructSet( 'page', $db );
1034  if ( $set === false ) {
1035  break;
1036  }
1037 
1038  // Get pageIDs data from the `page` table
1039  $res = $db->select( 'page', $pageFlds, $set, __METHOD__ );
1040 
1041  // Hack: get the ns:titles stored in [ns => array(titles)] format
1042  $this->initFromQueryResult( $res, $linkBatch->data, true );
1043  }
1044  }
1045  }
1046 
1054  private function getRedirectTargets() {
1055  $titlesToResolve = [];
1056  $db = $this->getDB();
1057 
1058  if ( $this->mPendingRedirectIDs ) {
1059  $res = $db->select(
1060  'redirect',
1061  [
1062  'rd_from',
1063  'rd_namespace',
1064  'rd_fragment',
1065  'rd_interwiki',
1066  'rd_title'
1067  ], [ 'rd_from' => array_keys( $this->mPendingRedirectIDs ) ],
1068  __METHOD__
1069  );
1070  foreach ( $res as $row ) {
1071  $rdfrom = (int)$row->rd_from;
1072  $from = $this->mPendingRedirectIDs[$rdfrom]->getPrefixedText();
1073  $to = Title::makeTitle(
1074  $row->rd_namespace,
1075  $row->rd_title,
1076  $row->rd_fragment,
1077  $row->rd_interwiki
1078  );
1079  $this->mResolvedRedirectTitles[$from] = $this->mPendingRedirectIDs[$rdfrom];
1080  unset( $this->mPendingRedirectIDs[$rdfrom] );
1081  if ( $to->isExternal() ) {
1082  $this->mInterwikiTitles[$to->getPrefixedText()] = $to->getInterwiki();
1083  } elseif ( !isset( $this->mAllPages[$to->getNamespace()][$to->getDBkey()] ) ) {
1084  $titlesToResolve[] = $to;
1085  }
1086  $this->mRedirectTitles[$from] = $to;
1087  }
1088 
1089  if ( $this->mPendingRedirectIDs ) {
1090  // We found pages that aren't in the redirect table
1091  // Add them
1092  foreach ( $this->mPendingRedirectIDs as $id => $title ) {
1093  $page = WikiPage::factory( $title );
1094  $rt = $page->insertRedirect();
1095  if ( !$rt ) {
1096  // What the hell. Let's just ignore this
1097  continue;
1098  }
1099  if ( $rt->isExternal() ) {
1100  $this->mInterwikiTitles[$rt->getPrefixedText()] = $rt->getInterwiki();
1101  } elseif ( !isset( $this->mAllPages[$rt->getNamespace()][$rt->getDBkey()] ) ) {
1102  $titlesToResolve[] = $rt;
1103  }
1104  $from = $title->getPrefixedText();
1105  $this->mResolvedRedirectTitles[$from] = $title;
1106  $this->mRedirectTitles[$from] = $rt;
1107  unset( $this->mPendingRedirectIDs[$id] );
1108  }
1109  }
1110  }
1111 
1112  if ( $this->mPendingRedirectSpecialPages ) {
1113  foreach ( $this->mPendingRedirectSpecialPages as $key => list( $from, $to ) ) {
1114  $fromKey = $from->getPrefixedText();
1115  $this->mResolvedRedirectTitles[$fromKey] = $from;
1116  $this->mRedirectTitles[$fromKey] = $to;
1117  if ( $to->isExternal() ) {
1118  $this->mInterwikiTitles[$to->getPrefixedText()] = $to->getInterwiki();
1119  } elseif ( !isset( $this->mAllPages[$to->getNamespace()][$to->getDBkey()] ) ) {
1120  $titlesToResolve[] = $to;
1121  }
1122  }
1123  $this->mPendingRedirectSpecialPages = [];
1124 
1125  // Set private caching since we don't know what criteria the
1126  // special pages used to decide on these redirects.
1127  $this->mCacheMode = 'private';
1128  }
1129 
1130  return $this->processTitlesArray( $titlesToResolve );
1131  }
1132 
1146  public function getCacheMode( $params = null ) {
1147  return $this->mCacheMode;
1148  }
1149 
1159  private function processTitlesArray( $titles ) {
1160  $usernames = [];
1161  $linkBatch = new LinkBatch();
1162  $services = MediaWikiServices::getInstance();
1163  $contLang = $services->getContentLanguage();
1164 
1165  foreach ( $titles as $title ) {
1166  if ( is_string( $title ) ) {
1167  try {
1168  $titleObj = Title::newFromTextThrow( $title, $this->mDefaultNamespace );
1169  } catch ( MalformedTitleException $ex ) {
1170  // Handle invalid titles gracefully
1171  if ( !isset( $this->mAllPages[0][$title] ) ) {
1172  $this->mAllPages[0][$title] = $this->mFakePageId;
1173  $this->mInvalidTitles[$this->mFakePageId] = [
1174  'title' => $title,
1175  'invalidreason' => $this->getErrorFormatter()->formatException( $ex, [ 'bc' => true ] ),
1176  ];
1177  $this->mFakePageId--;
1178  }
1179  continue; // There's nothing else we can do
1180  }
1181  } else {
1182  $titleObj = $title;
1183  }
1184  $unconvertedTitle = $titleObj->getPrefixedText();
1185  $titleWasConverted = false;
1186  if ( $titleObj->isExternal() ) {
1187  // This title is an interwiki link.
1188  $this->mInterwikiTitles[$unconvertedTitle] = $titleObj->getInterwiki();
1189  } else {
1190  // Variants checking
1191  if (
1192  $this->mConvertTitles && $contLang->hasVariants() && !$titleObj->exists()
1193  ) {
1194  // Language::findVariantLink will modify titleText and titleObj into
1195  // the canonical variant if possible
1196  $titleText = is_string( $title ) ? $title : $titleObj->getPrefixedText();
1197  $contLang->findVariantLink( $titleText, $titleObj );
1198  $titleWasConverted = $unconvertedTitle !== $titleObj->getPrefixedText();
1199  }
1200 
1201  if ( $titleObj->getNamespace() < 0 ) {
1202  // Handle Special and Media pages
1203  $titleObj = $titleObj->fixSpecialName();
1204  $ns = $titleObj->getNamespace();
1205  $dbkey = $titleObj->getDBkey();
1206  if ( !isset( $this->mAllSpecials[$ns][$dbkey] ) ) {
1207  $this->mAllSpecials[$ns][$dbkey] = $this->mFakePageId;
1208  $target = null;
1209  if ( $ns === NS_SPECIAL && $this->mResolveRedirects ) {
1210  $spFactory = $services->getSpecialPageFactory();
1211  $special = $spFactory->getPage( $dbkey );
1212  if ( $special instanceof RedirectSpecialArticle ) {
1213  // Only RedirectSpecialArticle is intended to redirect to an article, other kinds of
1214  // RedirectSpecialPage are probably applying weird URL parameters we don't want to handle.
1215  $context = new DerivativeContext( $this );
1216  $context->setTitle( $titleObj );
1217  $context->setRequest( new FauxRequest );
1218  $special->setContext( $context );
1219  list( /* $alias */, $subpage ) = $spFactory->resolveAlias( $dbkey );
1220  $target = $special->getRedirect( $subpage );
1221  }
1222  }
1223  if ( $target ) {
1224  $this->mPendingRedirectSpecialPages[$dbkey] = [ $titleObj, $target ];
1225  } else {
1226  $this->mSpecialTitles[$this->mFakePageId] = $titleObj;
1227  $this->mFakePageId--;
1228  }
1229  }
1230  } else {
1231  // Regular page
1232  $linkBatch->addObj( $titleObj );
1233  }
1234  }
1235 
1236  // Make sure we remember the original title that was
1237  // given to us. This way the caller can correlate new
1238  // titles with the originally requested when e.g. the
1239  // namespace is localized or the capitalization is
1240  // different
1241  if ( $titleWasConverted ) {
1242  $this->mConvertedTitles[$unconvertedTitle] = $titleObj->getPrefixedText();
1243  // In this case the page can't be Special.
1244  if ( is_string( $title ) && $title !== $unconvertedTitle ) {
1245  $this->mNormalizedTitles[$title] = $unconvertedTitle;
1246  }
1247  } elseif ( is_string( $title ) && $title !== $titleObj->getPrefixedText() ) {
1248  $this->mNormalizedTitles[$title] = $titleObj->getPrefixedText();
1249  }
1250 
1251  // Need gender information
1252  if ( MWNamespace::hasGenderDistinction( $titleObj->getNamespace() ) ) {
1253  $usernames[] = $titleObj->getText();
1254  }
1255  }
1256  // Get gender information
1257  $genderCache = $services->getGenderCache();
1258  $genderCache->doQuery( $usernames, __METHOD__ );
1259 
1260  return $linkBatch;
1261  }
1262 
1278  public function setGeneratorData( Title $title, array $data ) {
1279  $ns = $title->getNamespace();
1280  $dbkey = $title->getDBkey();
1281  $this->mGeneratorData[$ns][$dbkey] = $data;
1282  }
1283 
1303  public function setRedirectMergePolicy( $callable ) {
1304  $this->mRedirectMergePolicy = $callable;
1305  }
1306 
1327  public function populateGeneratorData( &$result, array $path = [] ) {
1328  if ( $result instanceof ApiResult ) {
1329  $data = $result->getResultData( $path );
1330  if ( $data === null ) {
1331  return true;
1332  }
1333  } else {
1334  $data = &$result;
1335  foreach ( $path as $key ) {
1336  if ( !isset( $data[$key] ) ) {
1337  // Path isn't in $result, so nothing to add, so everything
1338  // "fits"
1339  return true;
1340  }
1341  $data = &$data[$key];
1342  }
1343  }
1344  foreach ( $this->mGeneratorData as $ns => $dbkeys ) {
1345  if ( $ns === NS_SPECIAL ) {
1346  $pages = [];
1347  foreach ( $this->mSpecialTitles as $id => $title ) {
1348  $pages[$title->getDBkey()] = $id;
1349  }
1350  } else {
1351  if ( !isset( $this->mAllPages[$ns] ) ) {
1352  // No known titles in the whole namespace. Skip it.
1353  continue;
1354  }
1355  $pages = $this->mAllPages[$ns];
1356  }
1357  foreach ( $dbkeys as $dbkey => $genData ) {
1358  if ( !isset( $pages[$dbkey] ) ) {
1359  // Unknown title. Forget it.
1360  continue;
1361  }
1362  $pageId = $pages[$dbkey];
1363  if ( !isset( $data[$pageId] ) ) {
1364  // $pageId didn't make it into the result. Ignore it.
1365  continue;
1366  }
1367 
1368  if ( $result instanceof ApiResult ) {
1369  $path2 = array_merge( $path, [ $pageId ] );
1370  foreach ( $genData as $key => $value ) {
1371  if ( !$result->addValue( $path2, $key, $value ) ) {
1372  return false;
1373  }
1374  }
1375  } else {
1376  $data[$pageId] = array_merge( $data[$pageId], $genData );
1377  }
1378  }
1379  }
1380 
1381  // Merge data generated about redirect titles into the redirect destination
1382  if ( $this->mRedirectMergePolicy ) {
1383  foreach ( $this->mResolvedRedirectTitles as $titleFrom ) {
1384  $dest = $titleFrom;
1385  while ( isset( $this->mRedirectTitles[$dest->getPrefixedText()] ) ) {
1386  $dest = $this->mRedirectTitles[$dest->getPrefixedText()];
1387  }
1388  $fromNs = $titleFrom->getNamespace();
1389  $fromDBkey = $titleFrom->getDBkey();
1390  $toPageId = $dest->getArticleID();
1391  if ( isset( $data[$toPageId] ) &&
1392  isset( $this->mGeneratorData[$fromNs][$fromDBkey] )
1393  ) {
1394  // It is necessary to set both $data and add to $result, if an ApiResult,
1395  // to ensure multiple redirects to the same destination are all merged.
1396  $data[$toPageId] = call_user_func(
1397  $this->mRedirectMergePolicy,
1398  $data[$toPageId],
1399  $this->mGeneratorData[$fromNs][$fromDBkey]
1400  );
1401  if ( $result instanceof ApiResult &&
1402  !$result->addValue( $path, $toPageId, $data[$toPageId], ApiResult::OVERRIDE )
1403  ) {
1404  return false;
1405  }
1406  }
1407  }
1408  }
1409 
1410  return true;
1411  }
1412 
1417  protected function getDB() {
1418  return $this->mDbSource->getDB();
1419  }
1420 
1421  public function getAllowedParams( $flags = 0 ) {
1422  $result = [
1423  'titles' => [
1424  ApiBase::PARAM_ISMULTI => true,
1425  ApiBase::PARAM_HELP_MSG => 'api-pageset-param-titles',
1426  ],
1427  'pageids' => [
1428  ApiBase::PARAM_TYPE => 'integer',
1429  ApiBase::PARAM_ISMULTI => true,
1430  ApiBase::PARAM_HELP_MSG => 'api-pageset-param-pageids',
1431  ],
1432  'revids' => [
1433  ApiBase::PARAM_TYPE => 'integer',
1434  ApiBase::PARAM_ISMULTI => true,
1435  ApiBase::PARAM_HELP_MSG => 'api-pageset-param-revids',
1436  ],
1437  'generator' => [
1439  ApiBase::PARAM_HELP_MSG => 'api-pageset-param-generator',
1441  ],
1442  'redirects' => [
1443  ApiBase::PARAM_DFLT => false,
1444  ApiBase::PARAM_HELP_MSG => $this->mAllowGenerator
1445  ? 'api-pageset-param-redirects-generator'
1446  : 'api-pageset-param-redirects-nogenerator',
1447  ],
1448  'converttitles' => [
1449  ApiBase::PARAM_DFLT => false,
1450  ApiBase::PARAM_HELP_MSG => [
1451  'api-pageset-param-converttitles',
1453  ],
1454  ],
1455  ];
1456 
1457  if ( !$this->mAllowGenerator ) {
1458  unset( $result['generator'] );
1459  } elseif ( $flags & ApiBase::GET_VALUES_FOR_HELP ) {
1460  $result['generator'][ApiBase::PARAM_TYPE] = 'submodule';
1461  $result['generator'][ApiBase::PARAM_SUBMODULE_MAP] = $this->getGenerators();
1462  }
1463 
1464  return $result;
1465  }
1466 
1467  protected function handleParamNormalization( $paramName, $value, $rawValue ) {
1468  parent::handleParamNormalization( $paramName, $value, $rawValue );
1469 
1470  if ( $paramName === 'titles' ) {
1471  // For the 'titles' parameter, we want to split it like ApiBase would
1472  // and add any changed titles to $this->mNormalizedTitles
1473  $value = $this->explodeMultiValue( $value, self::LIMIT_SML2 + 1 );
1474  $l = count( $value );
1475  $rawValue = $this->explodeMultiValue( $rawValue, $l );
1476  for ( $i = 0; $i < $l; $i++ ) {
1477  if ( $value[$i] !== $rawValue[$i] ) {
1478  $this->mNormalizedTitles[$rawValue[$i]] = $value[$i];
1479  }
1480  }
1481  }
1482  }
1483 
1484  private static $generators = null;
1485 
1490  private function getGenerators() {
1491  if ( self::$generators === null ) {
1493  if ( !( $query instanceof ApiQuery ) ) {
1494  // If the parent container of this pageset is not ApiQuery,
1495  // we must create it to get module manager
1496  $query = $this->getMain()->getModuleManager()->getModule( 'query' );
1497  }
1498  $gens = [];
1499  $prefix = $query->getModulePath() . '+';
1500  $mgr = $query->getModuleManager();
1501  foreach ( $mgr->getNamesWithClasses() as $name => $class ) {
1502  if ( is_subclass_of( $class, ApiQueryGeneratorBase::class ) ) {
1503  $gens[$name] = $prefix . $name;
1504  }
1505  }
1506  ksort( $gens );
1507  self::$generators = $gens;
1508  }
1509 
1510  return self::$generators;
1511  }
1512 }
The wiki should then use memcached to cache various data To use multiple just add more items to the array To increase the weight of a make its entry a array("192.168.0.1:11211", 2))
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
Definition: WikiPage.php:138
static $generators
const PARAM_TYPE
(string|string[]) Either an array of allowed value strings, or a string type as described below...
Definition: ApiBase.php:88
getErrorFormatter()
Get the error formatter.
Definition: ApiBase.php:647
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition: deferred.txt:11
static addTitleInfo(&$arr, $title, $prefix='')
Add information (title and namespace) about a Title object to a result array.
setGeneratorData(Title $title, array $data)
Set data for a title.
getRedirectTitles()
Get a list of redirect resolutions - maps a title to its redirect target, as an array of output-ready...
Definition: ApiPageSet.php:443
null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
Definition: hooks.txt:1585
$data
Utility to generate mapping file used in mw.Title (phpCharToUpper.json)
$mGoodAndMissingPages
Definition: ApiPageSet.php:55
MalformedTitleException is thrown when a TitleParser is unable to parse a title string.
$mPendingRedirectSpecialPages
Definition: ApiPageSet.php:70
getSpecialTitles()
Get the list of titles with negative namespace.
Definition: ApiPageSet.php:703
const NS_MAIN
Definition: Defines.php:64
getDataSource()
Return the parameter name that is the source of data for this PageSet.
Definition: ApiPageSet.php:265
This class contains a list of pages that the client has requested.
Definition: ApiPageSet.php:40
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
const PARAM_DFLT
(null|boolean|integer|string) Default value of the parameter.
Definition: ApiBase.php:49
getMain()
Get the main module.
Definition: ApiBase.php:529
const GET_VALUES_FOR_HELP
getAllowedParams() flag: When set, the result could take longer to generate, but should be more thoro...
Definition: ApiBase.php:266
An IContextSource implementation which will inherit context from another source but allow individual ...
getConvertedTitles()
Get a list of title conversions - maps a title to its converted version.
Definition: ApiPageSet.php:524
getMissingRevisionIDs()
Revision IDs that were not found in the database.
Definition: ApiPageSet.php:675
$value
const NS_SPECIAL
Definition: Defines.php:53
dieWithError( $msg, $code=null, $data=null, $httpCode=null)
Abort execution with an error.
Definition: ApiBase.php:1991
const PROTO_CURRENT
Definition: Defines.php:222
extractRequestParams( $options=[])
Using getAllowedParams(), this function makes an array of the values provided by the user...
Definition: ApiBase.php:744
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency MediaWikiServices
Definition: injection.txt:23
getMissingTitlesByNamespace()
Returns an array [ns][dbkey] => fake_page_id for all missing titles.
Definition: ApiPageSet.php:392
populateFromRevisionIDs( $revIDs)
Populate this PageSet from a list of revision IDs.
Definition: ApiPageSet.php:748
static newFromRow( $row)
Make a Title object from a DB row.
Definition: Title.php:519
getRevisionIDs()
Get the list of valid revision IDs (requested with the revids= parameter)
Definition: ApiPageSet.php:651
getTitleCount()
Returns the number of unique pages (not revisions) in the set.
Definition: ApiPageSet.php:359
IContextSource $context
getAllTitlesByNamespace()
Returns an array [ns][dbkey] => page_id for all requested titles.
Definition: ApiPageSet.php:343
static setIndexedTagName(array &$arr, $tag)
Set the tag name for numeric-keyed values in XML format.
Definition: ApiResult.php:616
getPageTableFields()
Get the fields that have to be queried from the page table: the ones requested through requestField()...
Definition: ApiPageSet.php:307
getTitles()
All Title objects provided.
Definition: ApiPageSet.php:351
this hook is for auditing only RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist & $tables
Definition: hooks.txt:979
getLiveRevisionIDs()
Get the list of non-deleted revision IDs (requested with the revids= parameter)
Definition: ApiPageSet.php:659
The index of the header message $result[1]=The index of the body text message $result[2 through n]=Parameters passed to body text message. Please note the header message cannot receive/use parameters. 'ImportHandleLogItemXMLTag':When parsing a XML tag in a log item. Return false to stop further processing of the tag $reader:XMLReader object $logInfo:Array of information 'ImportHandlePageXMLTag':When parsing a XML tag in a page. Return false to stop further processing of the tag $reader:XMLReader object & $pageInfo:Array of information 'ImportHandleRevisionXMLTag':When parsing a XML tag in a page revision. Return false to stop further processing of the tag $reader:XMLReader object $pageInfo:Array of page information $revisionInfo:Array of revision information 'ImportHandleToplevelXMLTag':When parsing a top level XML tag. Return false to stop further processing of the tag $reader:XMLReader object 'ImportHandleUnknownUser':When a user doesn 't exist locally, this hook is called to give extensions an opportunity to auto-create it. If the auto-creation is successful, return false. $name:User name 'ImportHandleUploadXMLTag':When parsing a XML tag in a file upload. Return false to stop further processing of the tag $reader:XMLReader object $revisionInfo:Array of information 'ImportLogInterwikiLink':Hook to change the interwiki link used in log entries and edit summaries for transwiki imports. & $fullInterwikiPrefix:Interwiki prefix, may contain colons. & $pageTitle:String that contains page title. 'ImportSources':Called when reading from the $wgImportSources configuration variable. Can be used to lazy-load the import sources list. & $importSources:The value of $wgImportSources. Modify as necessary. See the comment in DefaultSettings.php for the detail of how to structure this array. 'InfoAction':When building information to display on the action=info page. $context:IContextSource object & $pageInfo:Array of information 'InitializeArticleMaybeRedirect':MediaWiki check to see if title is a redirect. & $title:Title object for the current page & $request:WebRequest & $ignoreRedirect:boolean to skip redirect check & $target:Title/string of redirect target & $article:Article object 'InternalParseBeforeLinks':during Parser 's internalParse method before links but after nowiki/noinclude/includeonly/onlyinclude and other processings. & $parser:Parser object & $text:string containing partially parsed text & $stripState:Parser 's internal StripState object 'InternalParseBeforeSanitize':during Parser 's internalParse method just before the parser removes unwanted/dangerous HTML tags and after nowiki/noinclude/includeonly/onlyinclude and other processings. Ideal for syntax-extensions after template/parser function execution which respect nowiki and HTML-comments. & $parser:Parser object & $text:string containing partially parsed text & $stripState:Parser 's internal StripState object 'InterwikiLoadPrefix':When resolving if a given prefix is an interwiki or not. Return true without providing an interwiki to continue interwiki search. $prefix:interwiki prefix we are looking for. & $iwData:output array describing the interwiki with keys iw_url, iw_local, iw_trans and optionally iw_api and iw_wikiid. 'InvalidateEmailComplete':Called after a user 's email has been invalidated successfully. $user:user(object) whose email is being invalidated 'IRCLineURL':When constructing the URL to use in an IRC notification. Callee may modify $url and $query, URL will be constructed as $url . $query & $url:URL to index.php & $query:Query string $rc:RecentChange object that triggered url generation 'IsFileCacheable':Override the result of Article::isFileCacheable()(if true) & $article:article(object) being checked 'IsTrustedProxy':Override the result of IP::isTrustedProxy() & $ip:IP being check & $result:Change this value to override the result of IP::isTrustedProxy() 'IsUploadAllowedFromUrl':Override the result of UploadFromUrl::isAllowedUrl() $url:URL used to upload from & $allowed:Boolean indicating if uploading is allowed for given URL 'isValidEmailAddr':Override the result of Sanitizer::validateEmail(), for instance to return false if the domain name doesn 't match your organization. $addr:The e-mail address entered by the user & $result:Set this and return false to override the internal checks 'isValidPassword':Override the result of User::isValidPassword() $password:The password entered by the user & $result:Set this and return false to override the internal checks $user:User the password is being validated for 'Language::getMessagesFileName':$code:The language code or the language we 're looking for a messages file for & $file:The messages file path, you can override this to change the location. 'LanguageGetNamespaces':Provide custom ordering for namespaces or remove namespaces. Do not use this hook to add namespaces. Use CanonicalNamespaces for that. & $namespaces:Array of namespaces indexed by their numbers 'LanguageGetTranslatedLanguageNames':Provide translated language names. & $names:array of language code=> language name $code:language of the preferred translations 'LanguageLinks':Manipulate a page 's language links. This is called in various places to allow extensions to define the effective language links for a page. $title:The page 's Title. & $links:Array with elements of the form "language:title" in the order that they will be output. & $linkFlags:Associative array mapping prefixed links to arrays of flags. Currently unused, but planned to provide support for marking individual language links in the UI, e.g. for featured articles. 'LanguageSelector':Hook to change the language selector available on a page. $out:The output page. $cssClassName:CSS class name of the language selector. 'LinkBegin':DEPRECATED since 1.28! Use HtmlPageLinkRendererBegin instead. Used when generating internal and interwiki links in Linker::link(), before processing starts. Return false to skip default processing and return $ret. See documentation for Linker::link() for details on the expected meanings of parameters. $skin:the Skin object $target:the Title that the link is pointing to & $html:the contents that the< a > tag should have(raw HTML) $result
Definition: hooks.txt:1980
callable null $mRedirectMergePolicy
Definition: ApiPageSet.php:84
initFromQueryResult( $res, &$remaining=null, $processTitles=null)
Iterate through the result of the query on &#39;page&#39; table, and for each row create and store title obje...
Definition: ApiPageSet.php:864
resolvePendingRedirects()
Resolve any redirects in the result if redirect resolution was requested.
Class representing a list of titles The execute() method checks them all for existence and adds them ...
Definition: LinkBatch.php:34
getGoodAndMissingTitlesByNamespace()
Returns an array [ns][dbkey] => page_id for all good and missing titles.
Definition: ApiPageSet.php:409
static addValues(array &$result, $values, $flags=[], $name=null)
Add all items from $values into the result.
Definition: ApiPageSet.php:93
getGoodTitleCount()
Returns the number of found unique pages (not revisions) in the set.
Definition: ApiPageSet.php:383
initFromPageIds( $pageids, $filterIds=true)
Does the same as initFromTitles(), but is based on page IDs instead.
Definition: ApiPageSet.php:824
const PARAM_SUBMODULE_PARAM_PREFIX
(string) When PARAM_TYPE is &#39;submodule&#39;, used to indicate the &#39;g&#39; prefix added by ApiQueryGeneratorBa...
Definition: ApiBase.php:173
getInvalidTitlesAndReasons()
Titles that were deemed invalid by Title::newFromText() The array&#39;s index will be unique and negative...
Definition: ApiPageSet.php:426
populateGeneratorData(&$result, array $path=[])
Populate the generator data for all titles in the result.
getGoodAndMissingTitles()
Title objects for good and missing titles.
Definition: ApiPageSet.php:417
populateFromTitles( $titles)
Populate this PageSet from a list of Titles.
Definition: ApiPageSet.php:719
static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title e g db for database replication lag or jobqueue for job queue size converted to pseudo seconds It is possible to add more fields and they will be returned to the user in the API response after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array $services
Definition: hooks.txt:2217
getDBkey()
Get the main part with underscores.
Definition: Title.php:1001
getGoodTitlesByNamespace()
Returns an array [ns][dbkey] => page_id for all good titles.
Definition: ApiPageSet.php:367
requestField( $fieldName)
Request an additional field from the page table.
Definition: ApiPageSet.php:287
$res
Definition: database.txt:21
getGenerators()
Get an array of all available generators.
executeDryRun()
In case execute() is not called, call this method to mark all relevant parameters as used This preven...
Definition: ApiPageSet.php:132
processTitlesArray( $titles)
Given an array of title strings, convert them into Title objects.
explodeMultiValue( $value, $limit)
Split a multi-valued parameter string, like explode()
Definition: ApiBase.php:1449
const PARAM_SUBMODULE_MAP
(string[]) When PARAM_TYPE is &#39;submodule&#39;, map parameter values to submodule paths.
Definition: ApiBase.php:166
getGoodTitles()
Title objects that were found in the database.
Definition: ApiPageSet.php:375
$params
getMissingTitles()
Title objects that were NOT found in the database.
Definition: ApiPageSet.php:401
getDB()
Get the database connection (read-only)
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that When $user is not null
Definition: hooks.txt:780
if(ini_get('mbstring.func_overload'))
Pre-config setup: Before loading LocalSettings.php.
Definition: Setup.php:51
namespace and then decline to actually register it file or subcat img or subcat $title
Definition: hooks.txt:925
getModuleName()
Get the name of the module being executed by this instance.
Definition: ApiBase.php:513
This class represents the result of the API operations.
Definition: ApiResult.php:35
getNamespace()
Get the namespace index, i.e.
Definition: Title.php:1025
This is the main query class.
Definition: ApiQuery.php:36
This document is intended to provide useful advice for parties seeking to redistribute MediaWiki to end users It s targeted particularly at maintainers for Linux since it s been observed that distribution packages of MediaWiki often break We ve consistently had to recommend that users seeking support use official tarballs instead of their distribution s and this often solves whatever problem the user is having It would be nice if this could such as
Definition: distributors.txt:9
getInvalidTitlesAndRevisions( $invalidChecks=[ 'invalidTitles', 'special', 'missingIds', 'missingRevIds', 'missingTitles', 'interwikiTitles'])
Get an array of invalid/special/missing titles.
Definition: ApiPageSet.php:601
const PARAM_HELP_MSG
(string|array|Message) Specify an alternative i18n documentation message for this parameter...
Definition: ApiBase.php:125
$mResolvedRedirectTitles
Definition: ApiPageSet.php:71
static newFromTextThrow( $text, $defaultNamespace=NS_MAIN)
Like Title::newFromText(), but throws MalformedTitleException when the title is invalid, rather than returning null.
Definition: Title.php:356
populateFromQueryResult( $db, $queryResult)
Populate this PageSet from a rowset returned from the database.
Definition: ApiPageSet.php:740
static getSelectFields()
Fields that LinkCache needs to select.
Definition: LinkCache.php:206
getAllowedParams( $flags=0)
int $mDefaultNamespace
Definition: ApiPageSet.php:82
getInterwikiTitlesAsResult( $result=null, $iwUrl=false)
Get a list of interwiki titles - maps a title to its interwiki prefix as result.
Definition: ApiPageSet.php:567
getMissingPageIDs()
Page IDs that were not found in the database.
Definition: ApiPageSet.php:434
static makeTitle( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:589
getInterwikiTitles()
Get a list of interwiki titles - maps a title to its interwiki prefix.
Definition: ApiPageSet.php:555
executeInternal( $isDryRun)
Populate the PageSet from the request parameters.
Definition: ApiPageSet.php:148
encodeParamName( $paramName)
This method mangles parameter name based on the prefix supplied to the constructor.
Definition: ApiBase.php:722
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition: injection.txt:35
getNormalizedTitlesAsResult( $result=null)
Get a list of title normalizations - maps a title to its normalized version in the form of result arr...
Definition: ApiPageSet.php:501
populateFromPageIDs( $pageIDs)
Populate this PageSet from a list of page IDs.
Definition: ApiPageSet.php:727
processDbRow( $row)
Extract all requested fields from the row received from the database.
Definition: ApiPageSet.php:756
filterIDs( $fields, array $ids)
Filter out-of-range values from a list of positive integer IDs.
Definition: ApiBase.php:1862
$mRequestedPageFields
Definition: ApiPageSet.php:80
linkcache txt The LinkCache class maintains a list of article titles and the information about whether or not the article exists in the database This is used to mark up links when displaying a page If the same link appears more than once on any page then it only has to be looked up once In most cases link lookups are done in batches with the LinkBatch class or the equivalent in so the link cache is mostly useful for short snippets of parsed and for links in the navigation areas of the skin The link cache was formerly used to track links used in a document for the purposes of updating the link tables This application is now deprecated To create a you can use the following $titles
Definition: linkcache.txt:17
getRedirectTargets()
Get the targets of the pending redirects from the database.
you have access to all of the normal MediaWiki so you can get a DB use the etc For full docs on the Maintenance class
Definition: maintenance.txt:52
initFromRevIDs( $revids)
Does the same as initFromTitles(), but is based on revision IDs instead.
Definition: ApiPageSet.php:935
addWarning( $msg, $code=null, $data=null)
Add a warning for this module.
Definition: ApiBase.php:1910
getCustomField( $fieldName)
Get the value of a custom field previously requested through requestField()
Definition: ApiPageSet.php:297
getNormalizedTitles()
Get a list of title normalizations - maps a title to its normalized version.
Definition: ApiPageSet.php:490
const PARAM_ISMULTI
(boolean) Accept multiple pipe-separated values for this parameter (e.g.
Definition: ApiBase.php:52
array $mInvalidTitles
[fake_page_id] => [ &#39;title&#39; => $title, &#39;invalidreason&#39; => $reason ]
Definition: ApiPageSet.php:61
__construct(ApiBase $dbSource, $flags=0, $defaultNamespace=NS_MAIN)
Definition: ApiPageSet.php:117
getMissingRevisionIDsAsResult( $result=null)
Revision IDs that were not found in the database as result array.
Definition: ApiPageSet.php:685
static dieDebug( $method, $message)
Internal code errors should be reported with this method.
Definition: ApiBase.php:2218
getConvertedTitlesAsResult( $result=null)
Get a list of title conversions - maps a title to its converted version as a result array...
Definition: ApiPageSet.php:535
This abstract class implements many basic API functions, and is the base of all API classes...
Definition: ApiBase.php:38
static hasGenderDistinction( $index)
Does the namespace (potentially) have different aliases for different genders.
setRedirectMergePolicy( $callable)
Controls how generator data about a redirect source is merged into the generator data for the redirec...
Allows to change the fields on the form that will be generated $name
Definition: hooks.txt:271
getCacheMode( $params=null)
Get the cache mode for the data generated by this module.
isResolvingRedirects()
Check whether this PageSet is resolving redirects.
Definition: ApiPageSet.php:253
getRevisionCount()
Returns the number of revisions (requested with revids= parameter).
Definition: ApiPageSet.php:711
initFromTitles( $titles)
This method populates internal variables with page information based on the given array of title stri...
Definition: ApiPageSet.php:796
const DISABLE_GENERATORS
Constructor flag: The new instance of ApiPageSet will ignore the &#39;generator=&#39; parameter.
Definition: ApiPageSet.php:45
Title [] $mPendingRedirectIDs
Definition: ApiPageSet.php:69
Superclass for any RedirectSpecialPage which redirects the user to a particular article (as opposed t...
static array $languagesWithVariants
languages supporting variants
const OVERRIDE
Override existing value in addValue(), setValue(), and similar functions.
Definition: ApiResult.php:41
handleParamNormalization( $paramName, $value, $rawValue)
execute()
Populate the PageSet from the request parameters.
Definition: ApiPageSet.php:139
static listParam(array $list, $type='text')
Definition: Message.php:1126
getDeletedRevisionIDs()
Get the list of revision IDs that were associated with deleted titles.
Definition: ApiPageSet.php:667
getRedirectTitlesAsResult( $result=null)
Get a list of redirect resolutions - maps a title to its redirect target.
Definition: ApiPageSet.php:454
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
static newFromText( $text, $defaultNamespace=NS_MAIN)
Create a new Title from text, such as what one would find in a link.
Definition: Title.php:319