Followup r87225
[lhc/web/wiklou.git] / maintenance / install-utils.inc
index c2c253e..7013033 100644 (file)
 <?php
-
 /**
- * This file contains functions used by the install script (config/index.php)
- * and maintenance scripts. It is not loaded in normal web requests.
+ * This file contains ancient db-related functions that have been deprecated. Do
+ * not use them. Please find the appropriate replacements.
+ *
+ * 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
  */
 
-function install_version_checks() {
-       # We dare not turn output buffer _off_ since this will break completely
-       # if PHP is globally configured to run through a gzip filter.
-       @ob_implicit_flush( true );
-
-       if ( !function_exists( 'version_compare' ) ) {
-               # version_compare was introduced in 4.1.0
-               echo "Your PHP version is much too old; 4.0.x will _not_ work. 5.1.0 or higher is required. ABORTING.\n";
-               die( 1 );
-       }
-       if ( version_compare( phpversion(), '5.1.0' ) < 0 ) {
-               echo "PHP 5.1.0 or higher is required. If PHP 5 is available only when \n" .
-               "PHP files have a .php5 extension, please navigate to <a href=\"index.php5\">index.php5</a> \n" .
-               "to continue installation. ABORTING.\n";
-               die( 1 );
-       }
-
-       $test = new PhpXmlBugTester();
-       if ( !$test->ok ) {
-               echo "Your system has a combination of PHP and libxml2 versions which is buggy\n" .
-                       "and can cause hidden data corruption in MediaWiki and other web apps.\n" .
-                       "Upgrade to PHP 5.2.9 or later and libxml2 2.7.3 or later!\n" .
-                       "ABORTING (http://bugs.php.net/bug.php?id=45996 for details).\n";
-               die( 1 );
-       }
-
-       $test = new PhpRefCallBugTester;
-       $test->execute();
-       if ( !$test->ok ) {
-               echo "PHP 5.3.1 is not compatible with MediaWiki due to a bug involving\n" .
-                       "reference parameters to __call. Upgrade to PHP 5.3.2 or higher, or \n" .
-                       "downgrade to PHP 5.3.0 to fix this.\n" .
-                       "ABORTING (see http://bugs.php.net/bug.php?id=50394 for details)\n";
-               die( 1 );
-       }
-
-       global $wgCommandLineMode;
-       $wgCommandLineMode = true;
-       umask( 000 );
-       @set_time_limit( 0 );
-}
-
 /**
- * Test for PHP+libxml2 bug which breaks XML input subtly with certain versions.
- * http://bugs.php.net/bug.php?id=45996
- * Known fixed with PHP 5.2.9 + libxml2-2.7.3
+ * @deprecated Use DatabaseBase::sourceFile(). Will probably be removed in 1.19
  */
-class PhpXmlBugTester {
-       private $parsedData = '';
-       public $ok = false;
-       public function __construct() {
-               $charData = '<b>c</b>';
-               $xml = '<a>' . htmlspecialchars( $charData ) . '</a>';
-
-               $parser = xml_parser_create();
-               xml_set_character_data_handler( $parser, array( $this, 'chardata' ) );
-               $parsedOk = xml_parse( $parser, $xml, true );
-               $this->ok = $parsedOk && ( $this->parsedData == $charData );
-       }
-       public function chardata( $parser, $data ) {
-               $this->parsedData .= $data;
-       }
-}
-
-/**
- * Test for PHP bug #50394 (PHP 5.3.x conversion to null only, not 5.2.x)
- */
-class PhpRefCallBugTester {
-       public $ok = false;
-
-       function __call( $name, $args ) {
-               $old = error_reporting( E_ALL & ~E_WARNING );
-               call_user_func_array( array( $this, 'checkForBrokenRef' ), $args );
-               error_reporting( $old );
-       }
-
-       function checkForBrokenRef( &$var ) {
-               if ( $var ) {
-                       $this->ok = true;
-               }
-       }
-
-       function execute() {
-               $var = true;
-               call_user_func_array( array( $this, 'foo' ), array( &$var ) );
-       }
-}
-
-if ( !function_exists( 'posix_isatty' ) ) {
-       # We default as considering stdin a tty (for nice readline methods)
-       # but treating stout as not a tty to avoid color codes
-       function posix_isatty( $fd ) {
-               return !$fd;
-       }
-}
-
-function readconsole( $prompt = '' ) {
-       static $isatty = null;
-       if ( is_null( $isatty ) ) {
-               if ( posix_isatty( 0 /*STDIN*/ ) ) {
-                       $isatty = true;
-               } else {
-                       $isatty = false;
-               }
-       }
-
-       if ( $isatty && function_exists( 'readline' ) ) {
-               return readline( $prompt );
-       } else {
-               if ( $isatty ) {
-                       $st = readlineEmulation( $prompt );
-               } else {
-                       if ( feof( STDIN ) ) {
-                               $st = false;
-                       } else {
-                               $st = fgets( STDIN, 1024 );
-                       }
-               }
-               if ( $st === false ) return false;
-               $resp = trim( $st );
-               return $resp;
-       }
-}
-
-function findExecutable( $name ) {
-       $paths = explode( PATH_SEPARATOR, getenv( "PATH" ) );
-       foreach ( $paths as $path ) {
-               $full = $path . DIRECTORY_SEPARATOR . $name;
-               if ( file_exists( $full ) ) {
-                       if ( wfIsWindows() || is_executable( $full ) ) {
-                               return $full;
-                       }
-               }
-       }
-       return false;
-}
-
-function readlineEmulation( $prompt ) {
-       $bash = "bash";
-       if ( !wfIsWindows() && findExecutable( $bash ) ) {
-               $retval = false;
-               $encPrompt = wfEscapeShellArg( $prompt );
-               $command = "read -er -p $encPrompt && echo \"\$REPLY\"";
-               $encCommand = wfEscapeShellArg( $command );
-               $line = wfShellExec( "$bash -c $encCommand", $retval );
-
-               if ( $retval == 0 ) {
-                       return $line;
-               } elseif ( $retval == 127 ) {
-                       // Couldn't execute bash even though we thought we saw it.
-                       // Shell probably spit out an error message, sorry :(
-                       // Fall through to fgets()...
-               } else {
-                       // EOF/ctrl+D
-                       return false;
-               }
-       }
-
-       // Fallback... we'll have no editing controls, EWWW
-       if ( feof( STDIN ) ) {
-               return false;
-       }
-       print $prompt;
-       return fgets( STDIN, 1024 );
-}
-
-
-#
-# Read and execute SQL commands from a file
-#
 function dbsource( $fname, $db = false ) {
        wfDeprecated( __METHOD__ );
        if ( !$db ) {
@@ -188,38 +35,3 @@ function dbsource( $fname, $db = false ) {
                exit( 1 );
        }
 }
-
-function archive( $name ) {
-       wfDeprecated( __METHOD__ );
-       return DatabaseBase::patchPath( $name );
-}
-
-/**
- * Get the value of session.save_path
- *
- * Per http://www.php.net/manual/en/ref.session.php#ini.session.save-path,
- * this might have some additional preceding parts which need to be
- * ditched
- *
- * @return string
- */
-function mw_get_session_save_path() {
-       $path = ini_get( 'session.save_path' );
-       $path = substr( $path, strrpos( $path, ';' ) );
-       return $path;
-}
-
-/**
- * Is dl() available to us?
- *
- * According to http://www.php.net/manual/en/function.dl.php, dl()
- * is *not* available when `enable_dl` is off, or under `safe_mode`
- *
- * @return bool
- */
-function mw_have_dl() {
-       return function_exists( 'dl' )
-               && is_callable( 'dl' )
-               && wfIniGetBool( 'enable_dl' )
-               && !wfIniGetBool( 'safe_mode' );
-}