Refactored parser output handling slightly, and added a hook function, to allow exten...

[lhc/web/wiklou.git] / includes / SiteConfiguration.php

diff --git a/includes/SiteConfiguration.php b/includes/SiteConfiguration.php
index aa0a6b5..8fd5d6b 100644 (file)
--- a/includes/SiteConfiguration.php
+++ b/includes/SiteConfiguration.php
@@ -1,23 +1,41 @@
 <?php
+/**
+ * This is a class used to hold configuration settings, particularly for multi-wiki sites.
+ *
+ * @package MediaWiki
+ */
 
-# This file is used to configure the live Wikimedia wikis. The file that includes
-# it contains passwords and other sensitive data, and there's currently no public
-# equivalent. 
+/**
+ * The include paths change after this file is included from commandLine.inc,
+ * meaning that require_once() fails to detect that it is including the same
+ * file again. We use DIY C-style protection as a workaround.
+ */
+if (!defined('SITE_CONFIGURATION')) {
+define('SITE_CONFIGURATION', 1);
 
+/** @package MediaWiki */
 class SiteConfiguration {
-       var $suffixes, $wikis, $settings;
-       var $localDatabases;
-       
+       var $suffixes = array();
+       var $wikis = array();
+       var $settings = array();
+       var $localVHosts = array();
+
+       /** */
        function get( $setting, $wiki, $suffix, $params = array() ) {
-               if ( array_key_exists( $wiki, $this->settings[$setting] ) ) {
-                       $retval = $this->settings[$setting][$wiki];
-               } elseif ( array_key_exists( $suffix, $this->settings[$setting] ) ) {
-                       $retval = $this->settings[$setting][$suffix];
-               } elseif ( array_key_exists( "default", $this->settings[$setting] ) ) {
-                       $retval = $this->settings[$setting]['default'];
+               if ( array_key_exists( $setting, $this->settings ) ) {
+                       if ( array_key_exists( $wiki, $this->settings[$setting] ) ) {
+                               $retval = $this->settings[$setting][$wiki];
+                       } elseif ( array_key_exists( $suffix, $this->settings[$setting] ) ) {
+                               $retval = $this->settings[$setting][$suffix];
+                       } elseif ( array_key_exists( 'default', $this->settings[$setting] ) ) {
+                               $retval = $this->settings[$setting]['default'];
+                       } else {
+                               $retval = NULL;
+                       }
                } else {
                        $retval = NULL;
                }
+
                if ( !is_null( $retval ) && count( $params ) ) {
                        foreach ( $params as $key => $value ) {
                                $retval = str_replace( '$' . $key, $value, $retval );
@@ -26,27 +44,41 @@ class SiteConfiguration {
                return $retval;
        }
 
+       /** */
+       function getAll( $wiki, $suffix, $params ) {
+               $localSettings = array();
+               foreach ( $this->settings as $varname => $stuff ) {
+                       $value = $this->get( $varname, $wiki, $suffix, $params );
+                       if ( !is_null( $value ) ) {
+                               $localSettings[$varname] = $value;
+                       }
+               }
+               return $localSettings;
+       }
+
+       /** */
        function getBool( $setting, $wiki, $suffix ) {
                return (bool)($this->get( $setting, $wiki, $suffix ));
        }
 
+       /** */
        function &getLocalDatabases() {
-               return $this->localDatabases();
+               return $this->wikis;
        }
-       
+
+       /** */
        function initialise() {
-               foreach ( $this->wikis as $db ) {
-                       $this->localDatabases[$db] = $db;
-               }
        }
 
+       /** */
        function extractVar( $setting, $wiki, $suffix, &$var, $params ) {
                $value = $this->get( $setting, $wiki, $suffix, $params );
                if ( !is_null( $value ) ) {
                        $var = $value;
                }
        }
-       
+
+       /** */
        function extractGlobal( $setting, $wiki, $suffix, $params ) {
                $value = $this->get( $setting, $wiki, $suffix, $params );
                if ( !is_null( $value ) ) {
@@ -54,12 +86,36 @@ class SiteConfiguration {
                }
        }
 
+       /** */
        function extractAllGlobals( $wiki, $suffix, $params ) {
                foreach ( $this->settings as $varName => $setting ) {
                        $this->extractGlobal( $varName, $wiki, $suffix, $params );
                }
        }
+
+       /**
+        * Work out the site and language name from a database name
+        * @param $db
+        */
+       function siteFromDB( $db ) {
+               $site = NULL;
+               $lang = NULL;
+               foreach ( $this->suffixes as $suffix ) {
+                       if ( substr( $db, -strlen( $suffix ) ) == $suffix ) {
+                               $site = $suffix == 'wiki' ? 'wikipedia' : $suffix;
+                               $lang = substr( $db, 0, strlen( $db ) - strlen( $suffix ) );
+                               break;
+                       }
+               }
+               $lang = str_replace( '_', '-', $lang );
+               return array( $site, $lang );
+       }
+
+       /** */
+       function isLocalVHost( $vhost ) {
+               return in_array( $vhost, $this->localVHosts );
+       }
+}
 }
 
-       
 ?>