Merge "Adds support to HTMLForm for rendering form fields wrapped in divs or just...
[lhc/web/wiklou.git] / includes / installer / LocalSettingsGenerator.php
index ca3ccf3..9ed486c 100644 (file)
 <?php
-
+/**
+ * Generator for LocalSettings.php file.
+ *
+ * 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
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Deployment
+ */
+
+/**
+ * Class for generating LocalSettings.php file.
+ *
+ * @ingroup Deployment
+ * @since 1.17
+ */
 class LocalSettingsGenerator {
-       private $extensions, $values = array();
-       private $configPath, $dbSettings = '';
+
+       private $extensions = array();
+       private $values = array();
+       private $groupPermissions = array();
+       private $dbSettings = '';
        private $safeMode = false;
+
+       /**
+        * @var Installer
+        */
        private $installer;
 
        /**
         * Constructor.
+        *
         * @param $installer Installer subclass
         */
        public function __construct( Installer $installer ) {
                $this->installer = $installer;
-               $this->configPath = $installer->getVar( 'IP' ) . '/config';
+
                $this->extensions = $installer->getVar( '_Extensions' );
+
                $db = $installer->getDBInstaller( $installer->getVar( 'wgDBtype' ) );
 
-               $confItems = array_merge( array( 'wgScriptPath', 'wgScriptExtension',
-                       'wgPasswordSender', 'wgImageMagickConvertCommand', 'wgShellLocale',
-                       'wgLanguageCode', 'wgEnableEmail', 'wgEnableUserEmail', 'wgDiff3',
-                       'wgEnotifUserTalk', 'wgEnotifWatchlist', 'wgEmailAuthentication',
-                       'wgDBtype', 'wgSecretKey', 'wgRightsUrl', 'wgSitename', 'wgRightsIcon',
-                       'wgRightsText', 'wgRightsCode', 'wgMainCacheType', 'wgEnableUploads',
-                       'wgMainCacheType', '_MemCachedServers', 'wgDBserver', 'wgDBuser',
-                       'wgDBpassword' ), $db->getGlobalNames() );
+               $confItems = array_merge(
+                       array(
+                               'wgServer', 'wgScriptPath', 'wgScriptExtension',
+                               'wgPasswordSender', 'wgImageMagickConvertCommand', 'wgShellLocale',
+                               'wgLanguageCode', 'wgEnableEmail', 'wgEnableUserEmail', 'wgDiff3',
+                               'wgEnotifUserTalk', 'wgEnotifWatchlist', 'wgEmailAuthentication',
+                               'wgDBtype', 'wgSecretKey', 'wgRightsUrl', 'wgSitename', 'wgRightsIcon',
+                               'wgRightsText', 'wgMainCacheType', 'wgEnableUploads',
+                               'wgMainCacheType', '_MemCachedServers', 'wgDBserver', 'wgDBuser',
+                               'wgDBpassword', 'wgUseInstantCommons', 'wgUpgradeKey', 'wgDefaultSkin',
+                               'wgMetaNamespace', 'wgResourceLoaderMaxQueryLength'
+                       ),
+                       $db->getGlobalNames()
+               );
+
                $unescaped = array( 'wgRightsIcon' );
-               $boolItems = array( 'wgEnableEmail', 'wgEnableUserEmail', 'wgEnotifUserTalk',
-                       'wgEnotifWatchlist', 'wgEmailAuthentication', 'wgEnableUploads' );
+               $boolItems = array(
+                       'wgEnableEmail', 'wgEnableUserEmail', 'wgEnotifUserTalk',
+                       'wgEnotifWatchlist', 'wgEmailAuthentication', 'wgEnableUploads', 'wgUseInstantCommons'
+               );
+
                foreach( $confItems as $c ) {
                        $val = $installer->getVar( $c );
+
                        if( in_array( $c, $boolItems ) ) {
                                $val = wfBoolToStr( $val );
                        }
+
                        if ( !in_array( $c, $unescaped ) ) {
                                $val = self::escapePhpString( $val );
                        }
+
                        $this->values[$c] = $val;
                }
+
                $this->dbSettings = $db->getLocalSettings();
                $this->safeMode = $installer->getVar( '_SafeMode' );
                $this->values['wgEmergencyContact'] = $this->values['wgPasswordSender'];
        }
 
+       /**
+        * For $wgGroupPermissions, set a given ['group']['permission'] value.
+        * @param $group String Group name
+        * @param $rightsArr Array An array of permissions, in the form of:
+        *   array( 'right' => true, 'right2' => false )
+        */
+       public function setGroupRights( $group, $rightsArr ) {
+               $this->groupPermissions[$group] = $rightsArr;
+       }
+
+       /**
+        * Returns the escaped version of a string of php code.
+        *
+        * @param $string String
+        *
+        * @return String
+        */
        public static function escapePhpString( $string ) {
                if ( is_array( $string ) || is_object( $string ) ) {
                        return false;
                }
-               return strtr( $string,
+
+               return strtr(
+                       $string,
                        array(
                                "\n" => "\\n",
                                "\r" => "\\r",
@@ -54,61 +123,70 @@ class LocalSettingsGenerator {
                                "\\" => "\\\\",
                                "\$" => "\\\$",
                                "\"" => "\\\""
-                       ));
+                       )
+               );
        }
 
        /**
         * Return the full text of the generated LocalSettings.php file,
         * including the extensions
-        * @returns String
+        *
+        * @return String
         */
        public function getText() {
                $localSettings = $this->getDefaultText();
+
                if( count( $this->extensions ) ) {
-                       $localSettings .= "\n# The following extensions were automatically enabled:\n";
-                       foreach( $this->extensions as $ext ) {
-                               $localSettings .= "require( 'extensions/$ext/$ext.php' );\n";
+                       $localSettings .= "
+# Enabled Extensions. Most extensions are enabled by including the base extension file here
+# but check specific extension documentation for more details
+# The following extensions were automatically enabled:\n";
+
+                       foreach( $this->extensions as $extName ) {
+                               $encExtName = self::escapePhpString( $extName );
+                               $localSettings .= "require_once( \"\$IP/extensions/$encExtName/$encExtName.php\" );\n";
                        }
                }
 
+               $localSettings .= "\n\n# End of automatically generated settings.
+# Add more configuration options below.\n\n";
+
                return $localSettings;
        }
 
        /**
-        * Write the file
-        * @param $secretKey String A random string to
-        * @return boolean On successful file write
+        * Write the generated LocalSettings to a file
+        *
+        * @param $fileName String Full path to filename to write to
         */
-       public function writeLocalSettings() {
-               $localSettings = $this->getText();
-               wfSuppressWarnings();
-               $ret = file_put_contents( $this->configPath . '/LocalSettings.php', $localSettings );
-               wfRestoreWarnings();
-
-               $status = Status::newGood();
-
-               if ( !$ret ) {
-                       $status->fatal( 'config-install-localsettings-unwritable', $localSettings );
-               }
-
-               return $status;
+       public function writeFile( $fileName ) {
+               file_put_contents( $fileName, $this->getText() );
        }
 
+       /**
+        * @return String
+        */
        private function buildMemcachedServerList() {
                $servers = $this->values['_MemCachedServers'];
+
                if( !$servers ) {
                        return 'array()';
                } else {
                        $ret = 'array( ';
                        $servers = explode( ',', $servers );
+
                        foreach( $servers as $srv ) {
                                $srv = trim( $srv );
                                $ret .= "'$srv', ";
                        }
+
                        return rtrim( $ret, ', ' ) . ' )';
                }
        }
 
+       /**
+        * @return String
+        */
        private function getDefaultText() {
                if( !$this->values['wgImageMagickConvertCommand'] ) {
                        $this->values['wgImageMagickConvertCommand'] = '/usr/bin/convert';
@@ -116,14 +194,34 @@ class LocalSettingsGenerator {
                } else {
                        $magic = '';
                }
+
                if( !$this->values['wgShellLocale'] ) {
                        $this->values['wgShellLocale'] = 'en_US.UTF-8';
                        $locale = '#';
                } else {
                        $locale = '';
                }
-               $rights = $this->values['wgRightsUrl'] ? '' : '#';
-               $hashedUploads = $this->safeMode ? '#' : '';
+
+               //$rightsUrl = $this->values['wgRightsUrl'] ? '' : '#'; // TODO: Fixme, I'm unused!
+               $hashedUploads = $this->safeMode ? '' : '#';
+               $metaNamespace = '';
+               if( $this->values['wgMetaNamespace'] !== $this->values['wgSitename'] ) {
+                       $metaNamespace = "\$wgMetaNamespace = \"{$this->values['wgMetaNamespace']}\";\n";
+               }
+
+               $groupRights = '';
+               if( $this->groupPermissions ) {
+                       $groupRights .= "# The following permissions were set based on your choice in the installer\n";
+                       foreach( $this->groupPermissions as $group => $rightArr ) {
+                               $group = self::escapePhpString( $group );
+                               foreach( $rightArr as $right => $perm ) {
+                                       $right = self::escapePhpString( $right );
+                                       $groupRights .= "\$wgGroupPermissions['$group']['$right'] = " .
+                                               wfBoolToStr( $perm ) . ";\n";
+                               }
+                       }
+               }
+
                switch( $this->values['wgMainCacheType'] ) {
                        case 'anything':
                        case 'db':
@@ -135,6 +233,7 @@ class LocalSettingsGenerator {
                        default:
                                $cacheType = 'CACHE_NONE';
                }
+
                $mcservers = $this->buildMemcachedServerList();
                return "<?php
 # This file was automatically generated by the MediaWiki {$GLOBALS['wgVersion']}
@@ -148,36 +247,27 @@ class LocalSettingsGenerator {
 # Further documentation for configuration settings may be found at:
 # http://www.mediawiki.org/wiki/Manual:Configuration_settings
 
-# If you customize your file layout, set \$IP to the directory that contains
-# the other MediaWiki files. It will be used as a base to locate files.
-if( defined( 'MW_INSTALL_PATH' ) ) {
-       \$IP = MW_INSTALL_PATH;
-} else {
-       \$IP = dirname( __FILE__ );
+# Protect against web entry
+if ( !defined( 'MEDIAWIKI' ) ) {
+       exit;
 }
 
-\$path = array( \$IP, \"\$IP/includes\", \"\$IP/languages\" );
-set_include_path( implode( PATH_SEPARATOR, \$path ) . PATH_SEPARATOR . get_include_path() );
-
-require_once( \"\$IP/includes/DefaultSettings.php\" );
-
-if ( \$wgCommandLineMode ) {
-       if ( isset( \$_SERVER ) && array_key_exists( 'REQUEST_METHOD', \$_SERVER ) ) {
-               die( \"This script must be run from the command line\\n\" );
-       }
-}
 ## Uncomment this to disable output compression
 # \$wgDisableOutputCompression = true;
 
-\$wgSitename         = \"{$this->values['wgSitename']}\";
-
+\$wgSitename      = \"{$this->values['wgSitename']}\";
+{$metaNamespace}
 ## The URL base path to the directory containing the wiki;
 ## defaults for all runtime URL paths are based off of this.
-## For more information on customizing the URLs please see:
+## For more information on customizing the URLs
+## (like /w/index.php/Page_title to /wiki/Page_title) please see:
 ## http://www.mediawiki.org/wiki/Manual:Short_URL
 \$wgScriptPath       = \"{$this->values['wgScriptPath']}\";
 \$wgScriptExtension  = \"{$this->values['wgScriptExtension']}\";
 
+## The protocol and server name to use in fully-qualified URLs
+\$wgServer           = \"{$this->values['wgServer']}\";
+
 ## The relative URL path to the skins directory
 \$wgStylePath        = \"\$wgScriptPath/skins\";
 
@@ -191,10 +281,10 @@ if ( \$wgCommandLineMode ) {
 \$wgEnableUserEmail  = {$this->values['wgEnableUserEmail']}; # UPO
 
 \$wgEmergencyContact = \"{$this->values['wgEmergencyContact']}\";
-\$wgPasswordSender = \"{$this->values['wgPasswordSender']}\";
+\$wgPasswordSender   = \"{$this->values['wgPasswordSender']}\";
 
-\$wgEnotifUserTalk = {$this->values['wgEnotifUserTalk']}; # UPO
-\$wgEnotifWatchlist = {$this->values['wgEnotifWatchlist']}; # UPO
+\$wgEnotifUserTalk      = {$this->values['wgEnotifUserTalk']}; # UPO
+\$wgEnotifWatchlist     = {$this->values['wgEnotifWatchlist']}; # UPO
 \$wgEmailAuthentication = {$this->values['wgEmailAuthentication']};
 
 ## Database settings
@@ -207,15 +297,18 @@ if ( \$wgCommandLineMode ) {
 {$this->dbSettings}
 
 ## Shared memory settings
-\$wgMainCacheType = $cacheType;
+\$wgMainCacheType    = $cacheType;
 \$wgMemCachedServers = $mcservers;
 
 ## To enable image uploads, make sure the 'images' directory
 ## is writable, then set this to true:
-\$wgEnableUploads       = {$this->values['wgEnableUploads']};
+\$wgEnableUploads  = {$this->values['wgEnableUploads']};
 {$magic}\$wgUseImageMagick = true;
 {$magic}\$wgImageMagickConvertCommand = \"{$this->values['wgImageMagickConvertCommand']}\";
 
+# InstantCommons allows wiki to use images from http://commons.wikimedia.org
+\$wgUseInstantCommons  = {$this->values['wgUseInstantCommons']};
+
 ## If you use ImageMagick (or any other shell command) on a
 ## Linux server, this will need to be set to the name of an
 ## available UTF-8 locale
@@ -227,40 +320,42 @@ if ( \$wgCommandLineMode ) {
 ## this, if it's not already uncommented:
 {$hashedUploads}\$wgHashedUploadDirectory = false;
 
-## If you have the appropriate support software installed
-## you can enable inline LaTeX equations:
-\$wgUseTeX           = false;
-
 ## Set \$wgCacheDirectory to a writable directory on the web server
 ## to make your wiki go slightly faster. The directory should not
 ## be publically accessible from the web.
 #\$wgCacheDirectory = \"\$IP/cache\";
 
-\$wgLocalInterwiki   = strtolower( \$wgSitename );
-
+# Site language code, should be one of the list in ./languages/Names.php
 \$wgLanguageCode = \"{$this->values['wgLanguageCode']}\";
 
 \$wgSecretKey = \"{$this->values['wgSecretKey']}\";
 
+# Site upgrade key. Must be set to a string (default provided) to turn on the
+# web installer while LocalSettings.php is in place
+\$wgUpgradeKey = \"{$this->values['wgUpgradeKey']}\";
+
 ## Default skin: you can change the default skin. Use the internal symbolic
 ## names, ie 'standard', 'nostalgia', 'cologneblue', 'monobook', 'vector':
-\$wgDefaultSkin = 'vector';
+\$wgDefaultSkin = \"{$this->values['wgDefaultSkin']}\";
 
 ## For attaching licensing metadata to pages, and displaying an
 ## appropriate copyright notice / icon. GNU Free Documentation
 ## License and Creative Commons licenses are supported so far.
-{$rights}\$wgEnableCreativeCommonsRdf = true;
 \$wgRightsPage = \"\"; # Set to the title of a wiki page that describes your license/copyright
-\$wgRightsUrl = \"{$this->values['wgRightsUrl']}\";
+\$wgRightsUrl  = \"{$this->values['wgRightsUrl']}\";
 \$wgRightsText = \"{$this->values['wgRightsText']}\";
 \$wgRightsIcon = \"{$this->values['wgRightsIcon']}\";
-# \$wgRightsCode = \"{$this->values['wgRightsCode']}\"; # Not yet used
 
+# Path to the GNU diff3 utility. Used for conflict resolution.
 \$wgDiff3 = \"{$this->values['wgDiff3']}\";
 
-# When you make changes to this configuration file, this will make
-# sure that cached pages are cleared.
-\$wgCacheEpoch = max( \$wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
-";
+# Query string length limit for ResourceLoader. You should only set this if
+# your web server has a query string length limit (then set it to that limit),
+# or if you have suhosin.get.max_value_length set in php.ini (then set it to
+# that value)
+\$wgResourceLoaderMaxQueryLength = {$this->values['wgResourceLoaderMaxQueryLength']};
+
+{$groupRights}";
        }
+
 }