MediaWiki  1.33.0
LinksUpdate.php
Go to the documentation of this file.
1 <?php
26 use Wikimedia\ScopedCallback;
27 
35 class LinksUpdate extends DataUpdate implements EnqueueableDataUpdate {
36  // @todo make members protected, but make sure extensions don't break
37 
39  public $mId;
40 
42  public $mTitle;
43 
46 
48  public $mLinks;
49 
51  public $mImages;
52 
54  public $mTemplates;
55 
57  public $mExternals;
58 
60  public $mCategories;
61 
63  public $mInterlangs;
64 
66  public $mInterwikis;
67 
69  public $mProperties;
70 
72  public $mRecursive;
73 
75  private $mRevision;
76 
80  private $linkInsertions = null;
81 
85  private $linkDeletions = null;
86 
90  private $externalLinkInsertions = null;
91 
95  private $externalLinkDeletions = null;
96 
100  private $propertyInsertions = null;
101 
105  private $propertyDeletions = null;
106 
110  private $user;
111 
113  private $db;
114 
121  function __construct( Title $title, ParserOutput $parserOutput, $recursive = true ) {
122  parent::__construct();
123 
124  $this->mTitle = $title;
125 
126  if ( !$this->mId ) {
127  // NOTE: subclasses may initialize mId before calling this constructor!
128  $this->mId = $title->getArticleID( Title::GAID_FOR_UPDATE );
129  }
130 
131  if ( !$this->mId ) {
132  throw new InvalidArgumentException(
133  "The Title object yields no ID. Perhaps the page doesn't exist?"
134  );
135  }
136 
137  $this->mParserOutput = $parserOutput;
138 
139  $this->mLinks = $parserOutput->getLinks();
140  $this->mImages = $parserOutput->getImages();
141  $this->mTemplates = $parserOutput->getTemplates();
142  $this->mExternals = $parserOutput->getExternalLinks();
143  $this->mCategories = $parserOutput->getCategories();
144  $this->mProperties = $parserOutput->getProperties();
145  $this->mInterwikis = $parserOutput->getInterwikiLinks();
146 
147  # Convert the format of the interlanguage links
148  # I didn't want to change it in the ParserOutput, because that array is passed all
149  # the way back to the skin, so either a skin API break would be required, or an
150  # inefficient back-conversion.
151  $ill = $parserOutput->getLanguageLinks();
152  $this->mInterlangs = [];
153  foreach ( $ill as $link ) {
154  list( $key, $title ) = explode( ':', $link, 2 );
155  $this->mInterlangs[$key] = $title;
156  }
157 
158  foreach ( $this->mCategories as &$sortkey ) {
159  # If the sortkey is longer then 255 bytes, it is truncated by DB, and then doesn't match
160  # when comparing existing vs current categories, causing T27254.
161  $sortkey = mb_strcut( $sortkey, 0, 255 );
162  }
163 
164  $this->mRecursive = $recursive;
165 
166  // Avoid PHP 7.1 warning from passing $this by reference
167  $linksUpdate = $this;
168  Hooks::run( 'LinksUpdateConstructed', [ &$linksUpdate ] );
169  }
170 
176  public function doUpdate() {
177  if ( $this->ticket ) {
178  // Make sure all links update threads see the changes of each other.
179  // This handles the case when updates have to batched into several COMMITs.
180  $scopedLock = self::acquirePageLock( $this->getDB(), $this->mId );
181  if ( !$scopedLock ) {
182  throw new RuntimeException( "Could not acquire lock for page ID '{$this->mId}'." );
183  }
184  }
185 
186  // Avoid PHP 7.1 warning from passing $this by reference
187  $linksUpdate = $this;
188  Hooks::run( 'LinksUpdate', [ &$linksUpdate ] );
189  $this->doIncrementalUpdate();
190 
191  // Commit and release the lock (if set)
192  ScopedCallback::consume( $scopedLock );
193  // Run post-commit hook handlers without DBO_TRX
195  $this->getDB(),
196  __METHOD__,
197  function () {
198  // Avoid PHP 7.1 warning from passing $this by reference
199  $linksUpdate = $this;
200  Hooks::run( 'LinksUpdateComplete', [ &$linksUpdate, $this->ticket ] );
201  }
202  ) );
203  }
204 
214  public static function acquirePageLock( IDatabase $dbw, $pageId, $why = 'atomicity' ) {
215  $key = "LinksUpdate:$why:pageid:$pageId";
216  $scopedLock = $dbw->getScopedLockAndFlush( $key, __METHOD__, 15 );
217  if ( !$scopedLock ) {
218  $logger = LoggerFactory::getInstance( 'SecondaryDataUpdate' );
219  $logger->info( "Could not acquire lock '{key}' for page ID '{page_id}'.", [
220  'key' => $key,
221  'page_id' => $pageId,
222  ] );
223  return null;
224  }
225 
226  return $scopedLock;
227  }
228 
229  protected function doIncrementalUpdate() {
230  # Page links
231  $existingPL = $this->getExistingLinks();
232  $this->linkDeletions = $this->getLinkDeletions( $existingPL );
233  $this->linkInsertions = $this->getLinkInsertions( $existingPL );
234  $this->incrTableUpdate( 'pagelinks', 'pl', $this->linkDeletions, $this->linkInsertions );
235 
236  # Image links
237  $existingIL = $this->getExistingImages();
238  $imageDeletes = $this->getImageDeletions( $existingIL );
239  $this->incrTableUpdate(
240  'imagelinks',
241  'il',
242  $imageDeletes,
243  $this->getImageInsertions( $existingIL ) );
244 
245  # Invalidate all image description pages which had links added or removed
246  $imageUpdates = $imageDeletes + array_diff_key( $this->mImages, $existingIL );
247  $this->invalidateImageDescriptions( $imageUpdates );
248 
249  # External links
250  $existingEL = $this->getExistingExternals();
251  $this->externalLinkDeletions = $this->getExternalDeletions( $existingEL );
252  $this->externalLinkInsertions = $this->getExternalInsertions(
253  $existingEL );
254  $this->incrTableUpdate(
255  'externallinks',
256  'el',
257  $this->externalLinkDeletions,
258  $this->externalLinkInsertions );
259 
260  # Language links
261  $existingLL = $this->getExistingInterlangs();
262  $this->incrTableUpdate(
263  'langlinks',
264  'll',
265  $this->getInterlangDeletions( $existingLL ),
266  $this->getInterlangInsertions( $existingLL ) );
267 
268  # Inline interwiki links
269  $existingIW = $this->getExistingInterwikis();
270  $this->incrTableUpdate(
271  'iwlinks',
272  'iwl',
273  $this->getInterwikiDeletions( $existingIW ),
274  $this->getInterwikiInsertions( $existingIW ) );
275 
276  # Template links
277  $existingTL = $this->getExistingTemplates();
278  $this->incrTableUpdate(
279  'templatelinks',
280  'tl',
281  $this->getTemplateDeletions( $existingTL ),
282  $this->getTemplateInsertions( $existingTL ) );
283 
284  # Category links
285  $existingCL = $this->getExistingCategories();
286  $categoryDeletes = $this->getCategoryDeletions( $existingCL );
287  $this->incrTableUpdate(
288  'categorylinks',
289  'cl',
290  $categoryDeletes,
291  $this->getCategoryInsertions( $existingCL ) );
292  $categoryInserts = array_diff_assoc( $this->mCategories, $existingCL );
293  $categoryUpdates = $categoryInserts + $categoryDeletes;
294 
295  # Page properties
296  $existingPP = $this->getExistingProperties();
297  $this->propertyDeletions = $this->getPropertyDeletions( $existingPP );
298  $this->incrTableUpdate(
299  'page_props',
300  'pp',
301  $this->propertyDeletions,
302  $this->getPropertyInsertions( $existingPP ) );
303 
304  # Invalidate the necessary pages
305  $this->propertyInsertions = array_diff_assoc( $this->mProperties, $existingPP );
306  $changed = $this->propertyDeletions + $this->propertyInsertions;
307  $this->invalidateProperties( $changed );
308 
309  # Invalidate all categories which were added, deleted or changed (set symmetric difference)
310  $this->invalidateCategories( $categoryUpdates );
311  $this->updateCategoryCounts( $categoryInserts, $categoryDeletes );
312 
313  # Refresh links of all pages including this page
314  # This will be in a separate transaction
315  if ( $this->mRecursive ) {
316  $this->queueRecursiveJobs();
317  }
318 
319  # Update the links table freshness for this title
320  $this->updateLinksTimestamp();
321  }
322 
329  protected function queueRecursiveJobs() {
330  $action = $this->getCauseAction();
331  $agent = $this->getCauseAgent();
332 
333  self::queueRecursiveJobsForTable( $this->mTitle, 'templatelinks', $action, $agent );
334  if ( $this->mTitle->getNamespace() == NS_FILE ) {
335  // Process imagelinks in case the title is or was a redirect
336  self::queueRecursiveJobsForTable( $this->mTitle, 'imagelinks', $action, $agent );
337  }
338 
339  $bc = $this->mTitle->getBacklinkCache();
340  // Get jobs for cascade-protected backlinks for a high priority queue.
341  // If meta-templates change to using a new template, the new template
342  // should be implicitly protected as soon as possible, if applicable.
343  // These jobs duplicate a subset of the above ones, but can run sooner.
344  // Which ever runs first generally no-ops the other one.
345  $jobs = [];
346  foreach ( $bc->getCascadeProtectedLinks() as $title ) {
348  $title,
349  [
350  'causeAction' => $action,
351  'causeAgent' => $agent
352  ]
353  );
354  }
355  JobQueueGroup::singleton()->push( $jobs );
356  }
357 
366  public static function queueRecursiveJobsForTable(
367  Title $title, $table, $action = 'unknown', $userName = 'unknown'
368  ) {
369  if ( $title->getBacklinkCache()->hasLinks( $table ) ) {
370  $job = new RefreshLinksJob(
371  $title,
372  [
373  'table' => $table,
374  'recursive' => true,
375  ] + Job::newRootJobParams( // "overall" refresh links job info
376  "refreshlinks:{$table}:{$title->getPrefixedText()}"
377  ) + [ 'causeAction' => $action, 'causeAgent' => $userName ]
378  );
379 
380  JobQueueGroup::singleton()->push( $job );
381  }
382  }
383 
387  private function invalidateCategories( $cats ) {
388  PurgeJobUtils::invalidatePages( $this->getDB(), NS_CATEGORY, array_keys( $cats ) );
389  }
390 
396  private function updateCategoryCounts( array $added, array $deleted ) {
397  global $wgUpdateRowsPerQuery;
398 
399  if ( !$added && !$deleted ) {
400  return;
401  }
402 
403  $domainId = $this->getDB()->getDomainID();
404  $wp = WikiPage::factory( $this->mTitle );
405  $lbf = MediaWikiServices::getInstance()->getDBLoadBalancerFactory();
406  // T163801: try to release any row locks to reduce contention
407  $lbf->commitAndWaitForReplication( __METHOD__, $this->ticket, [ 'domain' => $domainId ] );
408 
409  foreach ( array_chunk( array_keys( $added ), $wgUpdateRowsPerQuery ) as $addBatch ) {
410  $wp->updateCategoryCounts( $addBatch, [], $this->mId );
411  $lbf->commitAndWaitForReplication(
412  __METHOD__, $this->ticket, [ 'domain' => $domainId ] );
413  }
414 
415  foreach ( array_chunk( array_keys( $deleted ), $wgUpdateRowsPerQuery ) as $deleteBatch ) {
416  $wp->updateCategoryCounts( [], $deleteBatch, $this->mId );
417  $lbf->commitAndWaitForReplication(
418  __METHOD__, $this->ticket, [ 'domain' => $domainId ] );
419  }
420  }
421 
425  private function invalidateImageDescriptions( array $images ) {
426  PurgeJobUtils::invalidatePages( $this->getDB(), NS_FILE, array_keys( $images ) );
427  }
428 
436  private function incrTableUpdate( $table, $prefix, $deletions, $insertions ) {
437  $services = MediaWikiServices::getInstance();
438  $bSize = $services->getMainConfig()->get( 'UpdateRowsPerQuery' );
439  $lbf = $services->getDBLoadBalancerFactory();
440 
441  if ( $table === 'page_props' ) {
442  $fromField = 'pp_page';
443  } else {
444  $fromField = "{$prefix}_from";
445  }
446 
447  $deleteWheres = []; // list of WHERE clause arrays for each DB delete() call
448  if ( $table === 'pagelinks' || $table === 'templatelinks' || $table === 'iwlinks' ) {
449  $baseKey = ( $table === 'iwlinks' ) ? 'iwl_prefix' : "{$prefix}_namespace";
450 
451  $curBatchSize = 0;
452  $curDeletionBatch = [];
453  $deletionBatches = [];
454  foreach ( $deletions as $ns => $dbKeys ) {
455  foreach ( $dbKeys as $dbKey => $unused ) {
456  $curDeletionBatch[$ns][$dbKey] = 1;
457  if ( ++$curBatchSize >= $bSize ) {
458  $deletionBatches[] = $curDeletionBatch;
459  $curDeletionBatch = [];
460  $curBatchSize = 0;
461  }
462  }
463  }
464  if ( $curDeletionBatch ) {
465  $deletionBatches[] = $curDeletionBatch;
466  }
467 
468  foreach ( $deletionBatches as $deletionBatch ) {
469  $deleteWheres[] = [
470  $fromField => $this->mId,
471  $this->getDB()->makeWhereFrom2d( $deletionBatch, $baseKey, "{$prefix}_title" )
472  ];
473  }
474  } else {
475  if ( $table === 'langlinks' ) {
476  $toField = 'll_lang';
477  } elseif ( $table === 'page_props' ) {
478  $toField = 'pp_propname';
479  } else {
480  $toField = $prefix . '_to';
481  }
482 
483  $deletionBatches = array_chunk( array_keys( $deletions ), $bSize );
484  foreach ( $deletionBatches as $deletionBatch ) {
485  $deleteWheres[] = [ $fromField => $this->mId, $toField => $deletionBatch ];
486  }
487  }
488 
489  $domainId = $this->getDB()->getDomainID();
490 
491  foreach ( $deleteWheres as $deleteWhere ) {
492  $this->getDB()->delete( $table, $deleteWhere, __METHOD__ );
493  $lbf->commitAndWaitForReplication(
494  __METHOD__, $this->ticket, [ 'domain' => $domainId ]
495  );
496  }
497 
498  $insertBatches = array_chunk( $insertions, $bSize );
499  foreach ( $insertBatches as $insertBatch ) {
500  $this->getDB()->insert( $table, $insertBatch, __METHOD__, 'IGNORE' );
501  $lbf->commitAndWaitForReplication(
502  __METHOD__, $this->ticket, [ 'domain' => $domainId ]
503  );
504  }
505 
506  if ( count( $insertions ) ) {
507  Hooks::run( 'LinksUpdateAfterInsert', [ $this, $table, $insertions ] );
508  }
509  }
510 
517  private function getLinkInsertions( $existing = [] ) {
518  $arr = [];
519  foreach ( $this->mLinks as $ns => $dbkeys ) {
520  $diffs = isset( $existing[$ns] )
521  ? array_diff_key( $dbkeys, $existing[$ns] )
522  : $dbkeys;
523  foreach ( $diffs as $dbk => $id ) {
524  $arr[] = [
525  'pl_from' => $this->mId,
526  'pl_from_namespace' => $this->mTitle->getNamespace(),
527  'pl_namespace' => $ns,
528  'pl_title' => $dbk
529  ];
530  }
531  }
532 
533  return $arr;
534  }
535 
541  private function getTemplateInsertions( $existing = [] ) {
542  $arr = [];
543  foreach ( $this->mTemplates as $ns => $dbkeys ) {
544  $diffs = isset( $existing[$ns] ) ? array_diff_key( $dbkeys, $existing[$ns] ) : $dbkeys;
545  foreach ( $diffs as $dbk => $id ) {
546  $arr[] = [
547  'tl_from' => $this->mId,
548  'tl_from_namespace' => $this->mTitle->getNamespace(),
549  'tl_namespace' => $ns,
550  'tl_title' => $dbk
551  ];
552  }
553  }
554 
555  return $arr;
556  }
557 
564  private function getImageInsertions( $existing = [] ) {
565  $arr = [];
566  $diffs = array_diff_key( $this->mImages, $existing );
567  foreach ( $diffs as $iname => $dummy ) {
568  $arr[] = [
569  'il_from' => $this->mId,
570  'il_from_namespace' => $this->mTitle->getNamespace(),
571  'il_to' => $iname
572  ];
573  }
574 
575  return $arr;
576  }
577 
583  private function getExternalInsertions( $existing = [] ) {
584  $arr = [];
585  $diffs = array_diff_key( $this->mExternals, $existing );
586  foreach ( $diffs as $url => $dummy ) {
587  foreach ( LinkFilter::makeIndexes( $url ) as $index ) {
588  $arr[] = [
589  'el_from' => $this->mId,
590  'el_to' => $url,
591  'el_index' => $index,
592  'el_index_60' => substr( $index, 0, 60 ),
593  ];
594  }
595  }
596 
597  return $arr;
598  }
599 
608  private function getCategoryInsertions( $existing = [] ) {
609  global $wgCategoryCollation;
610  $diffs = array_diff_assoc( $this->mCategories, $existing );
611  $arr = [];
612  $contLang = MediaWikiServices::getInstance()->getContentLanguage();
613  $collation = Collation::singleton();
614  foreach ( $diffs as $name => $prefix ) {
616  $contLang->findVariantLink( $name, $nt, true );
617 
618  $type = MWNamespace::getCategoryLinkType( $this->mTitle->getNamespace() );
619 
620  # Treat custom sortkeys as a prefix, so that if multiple
621  # things are forced to sort as '*' or something, they'll
622  # sort properly in the category rather than in page_id
623  # order or such.
624  $sortkey = $collation->getSortKey( $this->mTitle->getCategorySortkey( $prefix ) );
625 
626  $arr[] = [
627  'cl_from' => $this->mId,
628  'cl_to' => $name,
629  'cl_sortkey' => $sortkey,
630  'cl_timestamp' => $this->getDB()->timestamp(),
631  'cl_sortkey_prefix' => $prefix,
632  'cl_collation' => $wgCategoryCollation,
633  'cl_type' => $type,
634  ];
635  }
636 
637  return $arr;
638  }
639 
647  private function getInterlangInsertions( $existing = [] ) {
648  $diffs = array_diff_assoc( $this->mInterlangs, $existing );
649  $arr = [];
650  foreach ( $diffs as $lang => $title ) {
651  $arr[] = [
652  'll_from' => $this->mId,
653  'll_lang' => $lang,
654  'll_title' => $title
655  ];
656  }
657 
658  return $arr;
659  }
660 
666  function getPropertyInsertions( $existing = [] ) {
667  $diffs = array_diff_assoc( $this->mProperties, $existing );
668 
669  $arr = [];
670  foreach ( array_keys( $diffs ) as $name ) {
671  $arr[] = $this->getPagePropRowData( $name );
672  }
673 
674  return $arr;
675  }
676 
693  private function getPagePropRowData( $prop ) {
695 
696  $value = $this->mProperties[$prop];
697 
698  $row = [
699  'pp_page' => $this->mId,
700  'pp_propname' => $prop,
701  'pp_value' => $value,
702  ];
703 
704  if ( $wgPagePropsHaveSortkey ) {
705  $row['pp_sortkey'] = $this->getPropertySortKeyValue( $value );
706  }
707 
708  return $row;
709  }
710 
723  private function getPropertySortKeyValue( $value ) {
724  if ( is_int( $value ) || is_float( $value ) || is_bool( $value ) ) {
725  return floatval( $value );
726  }
727 
728  return null;
729  }
730 
737  private function getInterwikiInsertions( $existing = [] ) {
738  $arr = [];
739  foreach ( $this->mInterwikis as $prefix => $dbkeys ) {
740  $diffs = isset( $existing[$prefix] )
741  ? array_diff_key( $dbkeys, $existing[$prefix] )
742  : $dbkeys;
743 
744  foreach ( $diffs as $dbk => $id ) {
745  $arr[] = [
746  'iwl_from' => $this->mId,
747  'iwl_prefix' => $prefix,
748  'iwl_title' => $dbk
749  ];
750  }
751  }
752 
753  return $arr;
754  }
755 
762  private function getLinkDeletions( $existing ) {
763  $del = [];
764  foreach ( $existing as $ns => $dbkeys ) {
765  if ( isset( $this->mLinks[$ns] ) ) {
766  $del[$ns] = array_diff_key( $existing[$ns], $this->mLinks[$ns] );
767  } else {
768  $del[$ns] = $existing[$ns];
769  }
770  }
771 
772  return $del;
773  }
774 
781  private function getTemplateDeletions( $existing ) {
782  $del = [];
783  foreach ( $existing as $ns => $dbkeys ) {
784  if ( isset( $this->mTemplates[$ns] ) ) {
785  $del[$ns] = array_diff_key( $existing[$ns], $this->mTemplates[$ns] );
786  } else {
787  $del[$ns] = $existing[$ns];
788  }
789  }
790 
791  return $del;
792  }
793 
800  private function getImageDeletions( $existing ) {
801  return array_diff_key( $existing, $this->mImages );
802  }
803 
810  private function getExternalDeletions( $existing ) {
811  return array_diff_key( $existing, $this->mExternals );
812  }
813 
820  private function getCategoryDeletions( $existing ) {
821  return array_diff_assoc( $existing, $this->mCategories );
822  }
823 
830  private function getInterlangDeletions( $existing ) {
831  return array_diff_assoc( $existing, $this->mInterlangs );
832  }
833 
839  private function getPropertyDeletions( $existing ) {
840  return array_diff_assoc( $existing, $this->mProperties );
841  }
842 
849  private function getInterwikiDeletions( $existing ) {
850  $del = [];
851  foreach ( $existing as $prefix => $dbkeys ) {
852  if ( isset( $this->mInterwikis[$prefix] ) ) {
853  $del[$prefix] = array_diff_key( $existing[$prefix], $this->mInterwikis[$prefix] );
854  } else {
855  $del[$prefix] = $existing[$prefix];
856  }
857  }
858 
859  return $del;
860  }
861 
867  private function getExistingLinks() {
868  $res = $this->getDB()->select( 'pagelinks', [ 'pl_namespace', 'pl_title' ],
869  [ 'pl_from' => $this->mId ], __METHOD__ );
870  $arr = [];
871  foreach ( $res as $row ) {
872  if ( !isset( $arr[$row->pl_namespace] ) ) {
873  $arr[$row->pl_namespace] = [];
874  }
875  $arr[$row->pl_namespace][$row->pl_title] = 1;
876  }
877 
878  return $arr;
879  }
880 
886  private function getExistingTemplates() {
887  $res = $this->getDB()->select( 'templatelinks', [ 'tl_namespace', 'tl_title' ],
888  [ 'tl_from' => $this->mId ], __METHOD__ );
889  $arr = [];
890  foreach ( $res as $row ) {
891  if ( !isset( $arr[$row->tl_namespace] ) ) {
892  $arr[$row->tl_namespace] = [];
893  }
894  $arr[$row->tl_namespace][$row->tl_title] = 1;
895  }
896 
897  return $arr;
898  }
899 
905  private function getExistingImages() {
906  $res = $this->getDB()->select( 'imagelinks', [ 'il_to' ],
907  [ 'il_from' => $this->mId ], __METHOD__ );
908  $arr = [];
909  foreach ( $res as $row ) {
910  $arr[$row->il_to] = 1;
911  }
912 
913  return $arr;
914  }
915 
921  private function getExistingExternals() {
922  $res = $this->getDB()->select( 'externallinks', [ 'el_to' ],
923  [ 'el_from' => $this->mId ], __METHOD__ );
924  $arr = [];
925  foreach ( $res as $row ) {
926  $arr[$row->el_to] = 1;
927  }
928 
929  return $arr;
930  }
931 
937  private function getExistingCategories() {
938  $res = $this->getDB()->select( 'categorylinks', [ 'cl_to', 'cl_sortkey_prefix' ],
939  [ 'cl_from' => $this->mId ], __METHOD__ );
940  $arr = [];
941  foreach ( $res as $row ) {
942  $arr[$row->cl_to] = $row->cl_sortkey_prefix;
943  }
944 
945  return $arr;
946  }
947 
954  private function getExistingInterlangs() {
955  $res = $this->getDB()->select( 'langlinks', [ 'll_lang', 'll_title' ],
956  [ 'll_from' => $this->mId ], __METHOD__ );
957  $arr = [];
958  foreach ( $res as $row ) {
959  $arr[$row->ll_lang] = $row->ll_title;
960  }
961 
962  return $arr;
963  }
964 
969  private function getExistingInterwikis() {
970  $res = $this->getDB()->select( 'iwlinks', [ 'iwl_prefix', 'iwl_title' ],
971  [ 'iwl_from' => $this->mId ], __METHOD__ );
972  $arr = [];
973  foreach ( $res as $row ) {
974  if ( !isset( $arr[$row->iwl_prefix] ) ) {
975  $arr[$row->iwl_prefix] = [];
976  }
977  $arr[$row->iwl_prefix][$row->iwl_title] = 1;
978  }
979 
980  return $arr;
981  }
982 
988  private function getExistingProperties() {
989  $res = $this->getDB()->select( 'page_props', [ 'pp_propname', 'pp_value' ],
990  [ 'pp_page' => $this->mId ], __METHOD__ );
991  $arr = [];
992  foreach ( $res as $row ) {
993  $arr[$row->pp_propname] = $row->pp_value;
994  }
995 
996  return $arr;
997  }
998 
1003  public function getTitle() {
1004  return $this->mTitle;
1005  }
1006 
1012  public function getParserOutput() {
1013  return $this->mParserOutput;
1014  }
1015 
1020  public function getImages() {
1021  return $this->mImages;
1022  }
1023 
1031  public function setRevision( Revision $revision ) {
1032  $this->mRevision = $revision;
1033  }
1034 
1039  public function getRevision() {
1040  return $this->mRevision;
1041  }
1042 
1049  public function setTriggeringUser( User $user ) {
1050  $this->user = $user;
1051  }
1052 
1057  public function getTriggeringUser() {
1058  return $this->user;
1059  }
1060 
1065  private function invalidateProperties( $changed ) {
1067 
1068  foreach ( $changed as $name => $value ) {
1069  if ( isset( $wgPagePropLinkInvalidations[$name] ) ) {
1071  if ( !is_array( $inv ) ) {
1072  $inv = [ $inv ];
1073  }
1074  foreach ( $inv as $table ) {
1076  new HTMLCacheUpdate( $this->mTitle, $table, 'page-props' )
1077  );
1078  }
1079  }
1080  }
1081  }
1082 
1088  public function getAddedLinks() {
1089  if ( $this->linkInsertions === null ) {
1090  return null;
1091  }
1092  $result = [];
1093  foreach ( $this->linkInsertions as $insertion ) {
1094  $result[] = Title::makeTitle( $insertion['pl_namespace'], $insertion['pl_title'] );
1095  }
1096 
1097  return $result;
1098  }
1099 
1105  public function getRemovedLinks() {
1106  if ( $this->linkDeletions === null ) {
1107  return null;
1108  }
1109  $result = [];
1110  foreach ( $this->linkDeletions as $ns => $titles ) {
1111  foreach ( $titles as $title => $unused ) {
1112  $result[] = Title::makeTitle( $ns, $title );
1113  }
1114  }
1115 
1116  return $result;
1117  }
1118 
1125  public function getAddedExternalLinks() {
1126  if ( $this->externalLinkInsertions === null ) {
1127  return null;
1128  }
1129  $result = [];
1130  foreach ( $this->externalLinkInsertions as $key => $value ) {
1131  $result[] = $value['el_to'];
1132  }
1133  return $result;
1134  }
1135 
1142  public function getRemovedExternalLinks() {
1143  if ( $this->externalLinkDeletions === null ) {
1144  return null;
1145  }
1146  return array_keys( $this->externalLinkDeletions );
1147  }
1148 
1155  public function getAddedProperties() {
1157  }
1158 
1165  public function getRemovedProperties() {
1166  return $this->propertyDeletions;
1167  }
1168 
1172  private function updateLinksTimestamp() {
1173  if ( $this->mId ) {
1174  // The link updates made here only reflect the freshness of the parser output
1175  $timestamp = $this->mParserOutput->getCacheTime();
1176  $this->getDB()->update( 'page',
1177  [ 'page_links_updated' => $this->getDB()->timestamp( $timestamp ) ],
1178  [ 'page_id' => $this->mId ],
1179  __METHOD__
1180  );
1181  }
1182  }
1183 
1187  protected function getDB() {
1188  if ( !$this->db ) {
1189  $this->db = wfGetDB( DB_MASTER );
1190  }
1191 
1192  return $this->db;
1193  }
1194 
1195  public function getAsJobSpecification() {
1196  if ( $this->user ) {
1197  $userInfo = [
1198  'userId' => $this->user->getId(),
1199  'userName' => $this->user->getName(),
1200  ];
1201  } else {
1202  $userInfo = false;
1203  }
1204 
1205  if ( $this->mRevision ) {
1206  $triggeringRevisionId = $this->mRevision->getId();
1207  } else {
1208  $triggeringRevisionId = false;
1209  }
1210 
1211  return [
1212  'domain' => $this->getDB()->getDomainID(),
1213  'job' => new JobSpecification(
1214  'refreshLinksPrioritized',
1215  [
1216  // Reuse the parser cache if it was saved
1217  'rootJobTimestamp' => $this->mParserOutput->getCacheTime(),
1218  'useRecursiveLinksUpdate' => $this->mRecursive,
1219  'triggeringUser' => $userInfo,
1220  'triggeringRevisionId' => $triggeringRevisionId,
1221  'causeAction' => $this->getCauseAction(),
1222  'causeAgent' => $this->getCauseAgent()
1223  ],
1224  [ 'removeDuplicates' => true ],
1225  $this->getTitle()
1226  )
1227  ];
1228  }
1229 }
LinksUpdate\getInterlangInsertions
getInterlangInsertions( $existing=[])
Get an array of interlanguage link insertions.
Definition: LinksUpdate.php:647
LinksUpdate\getTemplateInsertions
getTemplateInsertions( $existing=[])
Get an array of template insertions.
Definition: LinksUpdate.php:541
DataUpdate\getCauseAgent
getCauseAgent()
Definition: DataUpdate.php:67
LinksUpdate\invalidateImageDescriptions
invalidateImageDescriptions(array $images)
Definition: LinksUpdate.php:425
LinksUpdate\getTemplateDeletions
getTemplateDeletions( $existing)
Given an array of existing templates, returns those templates which are not in $this and thus should ...
Definition: LinksUpdate.php:781
LinksUpdate\getCategoryDeletions
getCategoryDeletions( $existing)
Given an array of existing categories, returns those categories which are not in $this and thus shoul...
Definition: LinksUpdate.php:820
LinksUpdate\getTriggeringUser
getTriggeringUser()
Definition: LinksUpdate.php:1057
LinksUpdate\doUpdate
doUpdate()
Update link tables with outgoing links from an updated article.
Definition: LinksUpdate.php:176
ParserOutput
Definition: ParserOutput.php:25
LinksUpdate\acquirePageLock
static acquirePageLock(IDatabase $dbw, $pageId, $why='atomicity')
Acquire a lock for performing link table updates for a page on a DB.
Definition: LinksUpdate.php:214
$lang
if(!isset( $args[0])) $lang
Definition: testCompression.php:33
LinksUpdate\getRemovedProperties
getRemovedProperties()
Fetch page properties removed by this LinksUpdate.
Definition: LinksUpdate.php:1165
LinksUpdate\$mInterwikis
array $mInterwikis
2-D map of (prefix => DBK => 1)
Definition: LinksUpdate.php:66
AutoCommitUpdate
Deferrable Update for closure/callback updates that should use auto-commit mode.
Definition: AutoCommitUpdate.php:9
LinksUpdate\getInterwikiDeletions
getInterwikiDeletions( $existing)
Given an array of existing interwiki links, returns those links which are not in $this and thus shoul...
Definition: LinksUpdate.php:849
captcha-old.count
count
Definition: captcha-old.py:249
LinksUpdate\setRevision
setRevision(Revision $revision)
Set the revision corresponding to this LinksUpdate.
Definition: LinksUpdate.php:1031
$result
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:1983
ParserOutput\getImages
& getImages()
Definition: ParserOutput.php:494
LinksUpdate\$mId
int $mId
Page ID of the article linked from.
Definition: LinksUpdate.php:39
LinksUpdate\$mCategories
array $mCategories
Map of category names to sort keys.
Definition: LinksUpdate.php:60
DeferredUpdates\addUpdate
static addUpdate(DeferrableUpdate $update, $stage=self::POSTSEND)
Add an update to the deferred list to be run later by execute()
Definition: DeferredUpdates.php:79
LinksUpdate\$externalLinkDeletions
null array $externalLinkDeletions
Deleted external links if calculated.
Definition: LinksUpdate.php:95
LinksUpdate
Class the manages updates of *_link tables as well as similar extension-managed tables.
Definition: LinksUpdate.php:35
NS_FILE
const NS_FILE
Definition: Defines.php:70
PurgeJobUtils\invalidatePages
static invalidatePages(IDatabase $dbw, $namespace, array $dbkeys)
Invalidate the cache of a list of pages from a single namespace.
Definition: PurgeJobUtils.php:35
RefreshLinksJob\newPrioritized
static newPrioritized(Title $title, array $params)
Definition: RefreshLinksJob.php:66
LinksUpdate\$mImages
array $mImages
DB keys of the images used, in the array key only.
Definition: LinksUpdate.php:51
LinksUpdate\$db
IDatabase $db
Definition: LinksUpdate.php:113
$res
$res
Definition: database.txt:21
LinksUpdate\getImageDeletions
getImageDeletions( $existing)
Given an array of existing images, returns those images which are not in $this and thus should be del...
Definition: LinksUpdate.php:800
LinksUpdate\updateLinksTimestamp
updateLinksTimestamp()
Update links table freshness.
Definition: LinksUpdate.php:1172
LinksUpdate\$propertyInsertions
null array $propertyInsertions
Added properties if calculated.
Definition: LinksUpdate.php:100
DataUpdate
Abstract base class for update jobs that do something with some secondary data extracted from article...
Definition: DataUpdate.php:28
ParserOutput\getProperties
getProperties()
Definition: ParserOutput.php:1022
LinksUpdate\getExternalDeletions
getExternalDeletions( $existing)
Given an array of existing external links, returns those links which are not in $this and thus should...
Definition: LinksUpdate.php:810
php
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
LinksUpdate\queueRecursiveJobs
queueRecursiveJobs()
Queue recursive jobs for this page.
Definition: LinksUpdate.php:329
Wikimedia\Rdbms\IDatabase
Basic database interface for live and lazy-loaded relation database handles.
Definition: IDatabase.php:38
LinksUpdate\getExistingImages
getExistingImages()
Get an array of existing images, image names in the keys.
Definition: LinksUpdate.php:905
LinkFilter\makeIndexes
static makeIndexes( $url)
Converts a URL into a format for el_index.
Definition: LinkFilter.php:171
LinksUpdate\incrTableUpdate
incrTableUpdate( $table, $prefix, $deletions, $insertions)
Update a table by doing a delete query then an insert query.
Definition: LinksUpdate.php:436
EnqueueableDataUpdate
Interface that marks a DataUpdate as enqueuable via the JobQueue.
Definition: EnqueueableDataUpdate.php:10
Collation\singleton
static singleton()
Definition: Collation.php:36
LinksUpdate\getLinkInsertions
getLinkInsertions( $existing=[])
Get an array of pagelinks insertions for passing to the DB Skips the titles specified by the 2-D arra...
Definition: LinksUpdate.php:517
Revision
Definition: Revision.php:40
LinksUpdate\getExistingTemplates
getExistingTemplates()
Get an array of existing templates, as a 2-D array.
Definition: LinksUpdate.php:886
LinksUpdate\getCategoryInsertions
getCategoryInsertions( $existing=[])
Get an array of category insertions.
Definition: LinksUpdate.php:608
$title
namespace and then decline to actually register it file or subcat img or subcat $title
Definition: hooks.txt:925
WikiPage\factory
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
Definition: WikiPage.php:138
LinksUpdate\updateCategoryCounts
updateCategoryCounts(array $added, array $deleted)
Update all the appropriate counts in the category table.
Definition: LinksUpdate.php:396
LinksUpdate\$mTemplates
array $mTemplates
Map of title strings to IDs for the template references, including broken ones.
Definition: LinksUpdate.php:54
user
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 and we might be restricted by PHP settings such as safe mode or open_basedir We cannot assume that the software even has read access anywhere useful Many shared hosts run all users web applications under the same user
Definition: distributors.txt:9
LinksUpdate\doIncrementalUpdate
doIncrementalUpdate()
Definition: LinksUpdate.php:229
LinksUpdate\$mProperties
array $mProperties
Map of arbitrary name to value.
Definition: LinksUpdate.php:69
$titles
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
LinksUpdate\getInterlangDeletions
getInterlangDeletions( $existing)
Given an array of existing interlanguage links, returns those links which are not in $this and thus s...
Definition: LinksUpdate.php:830
ParserOutput\getInterwikiLinks
getInterwikiLinks()
Definition: ParserOutput.php:446
wfGetDB
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
Definition: GlobalFunctions.php:2636
LinksUpdate\invalidateProperties
invalidateProperties( $changed)
Invalidate any necessary link lists related to page property changes.
Definition: LinksUpdate.php:1065
use
as see the revision history and available at free of to any person obtaining a copy of this software and associated documentation to deal in the Software without including without limitation the rights to use
Definition: MIT-LICENSE.txt:10
LinksUpdate\$mRevision
Revision $mRevision
Revision for which this update has been triggered.
Definition: LinksUpdate.php:75
LinksUpdate\$linkInsertions
null array $linkInsertions
Added links if calculated.
Definition: LinksUpdate.php:80
$wgUpdateRowsPerQuery
$wgUpdateRowsPerQuery
Number of rows to update per query.
Definition: DefaultSettings.php:8447
LinksUpdate\getAddedExternalLinks
getAddedExternalLinks()
Fetch external links added by this LinksUpdate.
Definition: LinksUpdate.php:1125
Title\makeTitle
static makeTitle( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:576
NS_CATEGORY
const NS_CATEGORY
Definition: Defines.php:78
LinksUpdate\getExistingProperties
getExistingProperties()
Get an array of existing categories, with the name in the key and sort key in the value.
Definition: LinksUpdate.php:988
LinksUpdate\getRemovedExternalLinks
getRemovedExternalLinks()
Fetch external links removed by this LinksUpdate.
Definition: LinksUpdate.php:1142
LinksUpdate\$mTitle
Title $mTitle
Title object of the article linked from.
Definition: LinksUpdate.php:42
DB_MASTER
const DB_MASTER
Definition: defines.php:26
LinksUpdate\getTitle
getTitle()
Return the title object of the page being updated.
Definition: LinksUpdate.php:1003
array
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))
Job\newRootJobParams
static newRootJobParams( $key)
Get "root job" parameters for a task.
Definition: Job.php:311
LinksUpdate\getImageInsertions
getImageInsertions( $existing=[])
Get an array of image insertions Skips the names specified in $existing.
Definition: LinksUpdate.php:564
ParserOutput\getLanguageLinks
& getLanguageLinks()
Definition: ParserOutput.php:442
list
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
LinksUpdate\__construct
__construct(Title $title, ParserOutput $parserOutput, $recursive=true)
Definition: LinksUpdate.php:121
LinksUpdate\getExistingInterlangs
getExistingInterlangs()
Get an array of existing interlanguage links, with the language code in the key and the title in the ...
Definition: LinksUpdate.php:954
ParserOutput\getExternalLinks
& getExternalLinks()
Definition: ParserOutput.php:502
$name
Allows to change the fields on the form that will be generated $name
Definition: hooks.txt:271
LinksUpdate\$mParserOutput
ParserOutput $mParserOutput
Definition: LinksUpdate.php:45
LinksUpdate\getParserOutput
getParserOutput()
Returns parser output.
Definition: LinksUpdate.php:1012
HTMLCacheUpdate
Class to invalidate the HTML cache of all the pages linking to a given title.
Definition: HTMLCacheUpdate.php:29
LinksUpdate\getAddedLinks
getAddedLinks()
Fetch page links added by this LinksUpdate.
Definition: LinksUpdate.php:1088
Title\makeTitleSafe
static makeTitleSafe( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:604
RefreshLinksJob
Job to update link tables for pages.
Definition: RefreshLinksJob.php:39
LinksUpdate\getInterwikiInsertions
getInterwikiInsertions( $existing=[])
Get an array of interwiki insertions for passing to the DB Skips the titles specified by the 2-D arra...
Definition: LinksUpdate.php:737
LinksUpdate\getAddedProperties
getAddedProperties()
Fetch page properties added by this LinksUpdate.
Definition: LinksUpdate.php:1155
$value
$value
Definition: styleTest.css.php:49
Wikimedia\Rdbms\IDatabase\getScopedLockAndFlush
getScopedLockAndFlush( $lockKey, $fname, $timeout)
Acquire a named lock, flush any transaction, and return an RAII style unlocker object.
Title\GAID_FOR_UPDATE
const GAID_FOR_UPDATE
Used to be GAID_FOR_UPDATE define.
Definition: Title.php:55
LinksUpdate\getExistingCategories
getExistingCategories()
Get an array of existing categories, with the name in the key and sort key in the value.
Definition: LinksUpdate.php:937
LinksUpdate\$linkDeletions
null array $linkDeletions
Deleted links if calculated.
Definition: LinksUpdate.php:85
LinksUpdate\getPagePropRowData
getPagePropRowData( $prop)
Returns an associative array to be used for inserting a row into the page_props table.
Definition: LinksUpdate.php:693
LinksUpdate\getExistingExternals
getExistingExternals()
Get an array of existing external links, URLs in the keys.
Definition: LinksUpdate.php:921
LinksUpdate\getPropertyDeletions
getPropertyDeletions( $existing)
Get array of properties which should be deleted.
Definition: LinksUpdate.php:839
$linksUpdate
either a unescaped string or a HtmlArmor object after in associative array form externallinks $linksUpdate
Definition: hooks.txt:2064
ParserOutput\getTemplates
& getTemplates()
Definition: ParserOutput.php:486
LinksUpdate\getImages
getImages()
Return the list of images used as generated by the parser.
Definition: LinksUpdate.php:1020
LinksUpdate\$mInterlangs
array $mInterlangs
Map of language codes to titles.
Definition: LinksUpdate.php:63
LinksUpdate\getAsJobSpecification
getAsJobSpecification()
Definition: LinksUpdate.php:1195
Title
Represents a title within MediaWiki.
Definition: Title.php:40
LinksUpdate\setTriggeringUser
setTriggeringUser(User $user)
Set the User who triggered this LinksUpdate.
Definition: LinksUpdate.php:1049
JobQueueGroup\singleton
static singleton( $domain=false)
Definition: JobQueueGroup.php:70
LinksUpdate\getRemovedLinks
getRemovedLinks()
Fetch page links removed by this LinksUpdate.
Definition: LinksUpdate.php:1105
LinksUpdate\$mExternals
array $mExternals
URLs of external links, array key only.
Definition: LinksUpdate.php:57
$job
if(count( $args)< 1) $job
Definition: recompressTracked.php:49
$wgPagePropLinkInvalidations
$wgPagePropLinkInvalidations
Page property link table invalidation lists.
Definition: DefaultSettings.php:7606
JobSpecification
Job queue task description base code.
Definition: JobSpecification.php:40
LinksUpdate\getPropertyInsertions
getPropertyInsertions( $existing=[])
Get an array of page property insertions.
Definition: LinksUpdate.php:666
LinksUpdate\$externalLinkInsertions
null array $externalLinkInsertions
Added external links if calculated.
Definition: LinksUpdate.php:90
ParserOutput\getCategories
& getCategories()
Definition: ParserOutput.php:454
MWNamespace\getCategoryLinkType
static getCategoryLinkType( $index)
Returns the link type to be used for categories.
Definition: MWNamespace.php:560
as
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
LinksUpdate\getExternalInsertions
getExternalInsertions( $existing=[])
Get an array of externallinks insertions.
Definition: LinksUpdate.php:583
LinksUpdate\$mRecursive
bool $mRecursive
Whether to queue jobs for recursive updates.
Definition: LinksUpdate.php:72
LinksUpdate\$user
User null $user
Definition: LinksUpdate.php:110
LinksUpdate\queueRecursiveJobsForTable
static queueRecursiveJobsForTable(Title $title, $table, $action='unknown', $userName='unknown')
Queue a RefreshLinks job for any table.
Definition: LinksUpdate.php:366
LinksUpdate\$propertyDeletions
null array $propertyDeletions
Deleted properties if calculated.
Definition: LinksUpdate.php:105
LinksUpdate\invalidateCategories
invalidateCategories( $cats)
Definition: LinksUpdate.php:387
$link
usually copyright or history_copyright This message must be in HTML not wikitext & $link
Definition: hooks.txt:3053
LoggerFactory
MediaWiki Logger LoggerFactory implements a PSR[0] compatible message logging system Named Psr Log LoggerInterface instances can be obtained from the MediaWiki Logger LoggerFactory::getInstance() static method. MediaWiki\Logger\LoggerFactory expects a class implementing the MediaWiki\Logger\Spi interface to act as a factory for new Psr\Log\LoggerInterface instances. The "Spi" in MediaWiki\Logger\Spi stands for "service provider interface". An SPI is an API intended to be implemented or extended by a third party. This software design pattern is intended to enable framework extension and replaceable components. It is specifically used in the MediaWiki\Logger\LoggerFactory service to allow alternate PSR-3 logging implementations to be easily integrated with MediaWiki. The service provider interface allows the backend logging library to be implemented in multiple ways. The $wgMWLoggerDefaultSpi global provides the classname of the default MediaWiki\Logger\Spi implementation to be loaded at runtime. This can either be the name of a class implementing the MediaWiki\Logger\Spi with a zero argument const ructor or a callable that will return an MediaWiki\Logger\Spi instance. Alternately the MediaWiki\Logger\LoggerFactory MediaWiki Logger LoggerFactory
Definition: logger.txt:5
true
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
Definition: hooks.txt:1985
$wgCategoryCollation
$wgCategoryCollation
Specify how category names should be sorted, when listed on a category page.
Definition: DefaultSettings.php:7658
DataUpdate\getCauseAction
getCauseAction()
Definition: DataUpdate.php:60
$services
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:2220
LinksUpdate\getExistingLinks
getExistingLinks()
Get an array of existing links, as a 2-D array.
Definition: LinksUpdate.php:867
$wgPagePropsHaveSortkey
$wgPagePropsHaveSortkey
Whether the page_props table has a pp_sortkey column.
Definition: DefaultSettings.php:8626
MediaWikiServices
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
LinksUpdate\getDB
getDB()
Definition: LinksUpdate.php:1187
User
The User object encapsulates all of the user-specific settings (user_id, name, rights,...
Definition: User.php:48
Hooks\run
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
LinksUpdate\getRevision
getRevision()
Definition: LinksUpdate.php:1039
LinksUpdate\$mLinks
array $mLinks
Map of title strings to IDs for the links in the document.
Definition: LinksUpdate.php:48
LinksUpdate\getPropertySortKeyValue
getPropertySortKeyValue( $value)
Determines the sort key for the given property value.
Definition: LinksUpdate.php:723
LinksUpdate\getLinkDeletions
getLinkDeletions( $existing)
Given an array of existing links, returns those links which are not in $this and thus should be delet...
Definition: LinksUpdate.php:762
ParserOutput\getLinks
& getLinks()
Definition: ParserOutput.php:482
LinksUpdate\getExistingInterwikis
getExistingInterwikis()
Get an array of existing inline interwiki links, as a 2-D array.
Definition: LinksUpdate.php:969
$type
$type
Definition: testCompression.php:48