Merge "Implement namespace inversion on WhatLinksHere"

[lhc/web/wiklou.git] / includes / site / SiteListFileCache.php

diff --git a/includes/site/SiteListFileCache.php b/includes/site/SiteListFileCache.php
index c0ecab1..e48a187 100644 (file)
--- a/includes/site/SiteListFileCache.php
+++ b/includes/site/SiteListFileCache.php
@@ -1,5 +1,4 @@
 <?php
-
 /**
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -16,12 +15,19 @@
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  * http://www.gnu.org/copyleft/gpl.html
  *
- * @since 1.25
- *
  * @file
  *
  * @license GNU GPL v2+
  */
+
+/**
+ * Provides a file-based cache of a SiteStore, stored as a json file.
+ * The cache can be built with the rebuildSitesCache.php maintenance script,
+ * and a MediaWiki instance can be setup to use this by setting the
+ * 'wgSitesCacheFile' configuration to the cache file location.
+ *
+ * @since 1.25
+ */
 class SiteListFileCache {
 
        /**
@@ -55,7 +61,11 @@ class SiteListFileCache {
        }
 
        /**
+        * @param string $globalId
+        *
         * @since 1.25
+        *
+        * @return Site|null
         */
        public function getSite( $globalId ) {
                $sites = $this->getSites();
@@ -72,7 +82,7 @@ class SiteListFileCache {
                $sites = new SiteList();
 
                // @todo lazy initialize the site objects in the site list (e.g. only when needed to access)
-               foreach( $data['sites'] as $siteArray ) {
+               foreach ( $data['sites'] as $siteArray ) {
                        $sites[] = $this->newSiteFromArray( $siteArray );
                }
 
@@ -116,7 +126,7 @@ class SiteListFileCache {
                $site->setExtraData( $data['data'] );
                $site->setExtraConfig( $data['config'] );
 
-               foreach( $data['identifiers'] as $identifier ) {
+               foreach ( $data['identifiers'] as $identifier ) {
                        $site->addLocalId( $identifier['type'], $identifier['key'] );
                }