When reading from meta's interwiki map, *.wikimedia.org should be set as local (e...
[lhc/web/wiklou.git] / includes / GlobalFunctions.php
index 23d1777..5b4d8bc 100644 (file)
@@ -111,6 +111,19 @@ if ( !function_exists( 'array_diff_key' ) ) {
 if ( ! function_exists( 'ctype_alnum' ) )
        require_once 'compatability/ctype.php';
 
+/**
+ * Wrapper for clone() for PHP 4, for the moment.
+ * PHP 5 won't let you declare a 'clone' function, even conditionally,
+ * so it has to be a wrapper with a different name.
+ */
+function wfClone( $object ) {
+       // WARNING: clone() is not a function in PHP 5, so function_exists fails.
+       if( version_compare( PHP_VERSION, '5.0' ) < 0 ) {
+               return $object;
+       } else {
+               return clone( $object );
+       }
+}
 
 /**
  * Where as we got a random seed
@@ -292,7 +305,7 @@ function wfReadOnly() {
 /**
  * Get a message from anywhere, for the current user language.
  *
- * Use wfMsgForContent() instead if the message should NOT 
+ * Use wfMsgForContent() instead if the message should NOT
  * change depending on the user preferences.
  *
  * Note that the message may contain HTML, and is therefore
@@ -300,7 +313,7 @@ function wfReadOnly() {
  * addWikiText will do the escaping for you. Use wfMsgHtml()
  * if you need an escaped message.
  *
- * @param string lookup key for the message, usually 
+ * @param string lookup key for the message, usually
  *    defined in languages/Language.php
  */
 function wfMsg( $key ) {
@@ -321,23 +334,23 @@ function wfMsgNoTrans( $key ) {
 /**
  * Get a message from anywhere, for the current global language
  * set with $wgLanguageCode.
- * 
- * Use this if the message should NOT change  dependent on the 
- * language set in the user's preferences. This is the case for 
- * most text written into logs, as well as link targets (such as 
- * the name of the copyright policy page). Link titles, on the 
+ *
+ * Use this if the message should NOT change  dependent on the
+ * language set in the user's preferences. This is the case for
+ * most text written into logs, as well as link targets (such as
+ * the name of the copyright policy page). Link titles, on the
  * other hand, should be shown in the UI language.
  *
- * Note that MediaWiki allows users to change the user interface 
- * language in their preferences, but a single installation 
+ * Note that MediaWiki allows users to change the user interface
+ * language in their preferences, but a single installation
  * typically only contains content in one language.
- * 
- * Be wary of this distinction: If you use wfMsg() where you should 
- * use wfMsgForContent(), a user of the software may have to 
+ *
+ * Be wary of this distinction: If you use wfMsg() where you should
+ * use wfMsgForContent(), a user of the software may have to
  * customize over 70 messages in order to, e.g., fix a link in every
  * possible language.
  *
- * @param string lookup key for the message, usually 
+ * @param string lookup key for the message, usually
  *    defined in languages/Language.php
  */
 function wfMsgForContent( $key ) {
@@ -434,7 +447,7 @@ function wfMsgGetKey( $key, $useDB, $forContent = false, $transform = true ) {
 
        if ( is_object( $wgMessageCache ) )
                $transstat = $wgMessageCache->getTransform();
-       
+
        if( is_object( $wgMessageCache ) ) {
                if ( ! $transform )
                        $wgMessageCache->disableTransform();
@@ -463,7 +476,7 @@ function wfMsgGetKey( $key, $useDB, $forContent = false, $transform = true ) {
 
        if ( is_object( $wgMessageCache ) && ! $transform )
                $wgMessageCache->setTransform( $transstat );
-       
+
        return $message;
 }
 
@@ -481,16 +494,19 @@ function wfMsgReplaceArgs( $message, $args ) {
        $message = str_replace( "\r", '', $message );
 
        // Replace arguments
-       if ( count( $args ) )
-               if ( is_array( $args[0] ) )
-                       foreach ( $args[0] as $key => $val )
+       if ( count( $args ) ) {
+               if ( is_array( $args[0] ) ) {
+                       foreach ( $args[0] as $key => $val ) {
                                $message = str_replace( '$' . $key, $val, $message );
-       else {
-               foreach( $args as $n => $param )
-                       $replacementKeys['$' . ($n + 1)] = $param;
-               $message = strtr( $message, $replacementKeys );
+                       }
+               } else {
+                       foreach( $args as $n => $param ) {
+                               $replacementKeys['$' . ($n + 1)] = $param;
+                       }
+                       $message = strtr( $message, $replacementKeys );
+               }
        }
-       
+
        return $message;
 }
 
@@ -537,7 +553,7 @@ function wfAbruptExit( $error = false ){
        global $wgLoadBalancer;
        static $called = false;
        if ( $called ){
-               exit();
+               exit( -1 );
        }
        $called = true;
 
@@ -558,7 +574,7 @@ function wfAbruptExit( $error = false ){
        if ( !$error ) {
                $wgLoadBalancer->closeAll();
        }
-       exit();
+       exit( -1 );
 }
 
 /**
@@ -568,6 +584,16 @@ function wfErrorExit() {
        wfAbruptExit( true );
 }
 
+/**
+ * Print a simple message and die, returning nonzero to the shell if any.
+ * Plain die() fails to return nonzero to the shell if you pass a string.
+ * @param string $msg
+ */
+function wfDie( $msg='' ) {
+       echo $msg;
+       die( -1 );
+}
+
 /**
  * Die with a backtrace
  * This is meant as a debugging aid to track down where bad data comes from.
@@ -707,7 +733,6 @@ function wfViewPrevNext( $offset, $limit, $link, $query = '', $atend = false ) {
                }
        }
 
-       $sk = $wgUser->getSkin();
        if ( 0 != $offset ) {
                $po = $offset - $limit;
                if ( $po < 0 ) { $po = 0; }
@@ -1212,7 +1237,7 @@ define('TS_RFC2822', 3);
 /**
  * ISO 8601 format with no timezone: 1986-02-09T20:00:00Z
  *
- * This is used by Special:Export 
+ * This is used by Special:Export
  */
 define('TS_ISO_8601', 4);
 
@@ -1328,49 +1353,66 @@ function swap( &$x, &$y ) {
        $y = $z;
 }
 
-function wfGetSiteNotice() {
-       global $wgSiteNotice, $wgTitle, $wgOut, $parserMemc, $wgDBname;
-       $fname = 'wfGetSiteNotice';
+function wfGetCachedNotice( $name ) {
+       global $wgOut, $parserMemc, $wgDBname;
+       $fname = 'wfGetCachedNotice';
        wfProfileIn( $fname );
-
-       $shouldParse=false;
-
-       $notice = wfMsgForContent( 'sitenotice' );
-       if( $notice == '&lt;sitenotice&gt;' || $notice == '-' ) {
-               $notice = '';
-       }
-       if( $notice == '' ) {
-               # We may also need to override a message with eg downtime info
-               # FIXME: make this work!
-               $notice = $wgSiteNotice;
+       
+       $needParse = false;
+       $notice = wfMsgForContent( $name );
+       if( $notice == '&lt;'. $name . ';&gt' || $notice == '-' ) {
+               wfProfileOut( $fname );
+               return( false );
        }
-       if($notice != '-' && $notice != '') {
-               $cachednotice=$parserMemc->get("{$wgDBname}:sitenotice");
-               if (is_array($cachednotice)) {
-                       if (md5($notice)==$cachednotice['hash']) {
-                               $notice = $cachednotice['html'];
-                       } else {
-                               $shouldParse=true;
-                       }
+       
+       $cachedNotice = $parserMemc->get( $wgDBname . ':' . $name );
+       if( is_array( $cachedNotice ) ) {
+               if( md5( $notice ) == $cachedNotice['hash'] ) {
+                       $notice = $cachedNotice['html'];
                } else {
-                       $shouldParse=true;
+                       $needParse = true;
                }
-               if ($shouldParse) {
-                       if( is_object( $wgOut ) ) {
-                               $parsed = $wgOut->parse( $notice );
-                               $parserMemc->set("{$wgDBname}:sitenotice",
-                                       array('html' => $parsed, 'hash' => md5($notice)), 600);
-                               $notice = $parsed;
-                       } else {
-                               wfDebug( "wfGetSiteNotice called with no \$wgOut available" );
-                               $notice = '';
-                       }
+       } else {
+               $needParse = true;
+       }
+       
+       if( $needParse ) {
+               if( is_object( $wgOut ) ) {
+                       $parsed = $wgOut->parse( $notice );
+                       $parserMemc->set( $wgDBname . ':' . $name, array( 'html' => $parsed, 'hash' => md5( $notice ) ), 600 );
+                       $notice = $parsed;
+               } else {
+                       wfDebug( 'wfGetCachedNotice called for ' . $name . ' with no $wgOut available' );
+                       $notice = '';
                }
        }
+       
        wfProfileOut( $fname );
        return $notice;
 }
 
+function wfGetSiteNotice() {
+       global $wgUser, $wgSiteNotice;
+       $fname = 'wfGetSiteNotice';
+       wfProfileIn( $fname );
+       
+       if( $wgUser->isLoggedIn() ) {
+               $siteNotice = wfGetCachedNotice( 'sitenotice' );
+               $siteNotice = !$siteNotice ? $wgSiteNotice : $siteNotice;
+       } else {
+               $anonNotice = wfGetCachedNotice( 'anonnotice' );
+               if( !$anonNotice ) {
+                       $siteNotice = wfGetCachedNotice( 'sitenotice' );
+                       $siteNotice = !$siteNotice ? $wgSiteNotice : $siteNotice;
+               } else {
+                       $siteNotice = $anonNotice;
+               }
+       }
+       
+       wfProfileOut( $fname );
+       return( $siteNotice );
+}
+
 /**
  * Format an XML element with given attributes and, optionally, text content.
  * Element and attribute names are assumed to be ready for literal inclusion.
@@ -1468,7 +1510,7 @@ function &HTMLnamespaceselector($selected = '', $allnamespaces = null) {
 /** Global singleton instance of MimeMagic. This is initialized on demand,
 * please always use the wfGetMimeMagic() function to get the instance.
 *
-* @private
+* @access private
 */
 $wgMimeMagic= NULL;
 
@@ -1523,7 +1565,7 @@ function wfTempDir() {
 function wfMkdirParents( $fullDir, $mode ) {
        $parts = explode( '/', $fullDir );
        $path = '';
-       
+
        foreach ( $parts as $dir ) {
                $path .= $dir . '/';
                if ( !is_dir( $path ) ) {
@@ -1621,7 +1663,7 @@ function wfUrlProtocols() {
        $protocols = array();
        foreach ($wgUrlProtocols as $protocol)
                $protocols[] = preg_quote( $protocol, '/' );
-       
+
        return implode( '|', $protocols );
 }
 
@@ -1636,10 +1678,10 @@ function wfUrlProtocols() {
  */
 function wfIsWellFormedXml( $text ) {
        $parser = xml_parser_create( "UTF-8" );
-       
+
        # case folding violates XML standard, turn it off
        xml_parser_set_option( $parser, XML_OPTION_CASE_FOLDING, false );
-       
+
        if( !xml_parse( $parser, $text, true ) ) {
                $err = xml_error_string( xml_get_error_code( $parser ) );
                $position = xml_get_current_byte_index( $parser );
@@ -1661,9 +1703,8 @@ function wfIsWellFormedXml( $text ) {
  * @return bool
  */
 function wfIsWellFormedXmlFragment( $text ) {
-       $html = 
-               '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ' .
-               '"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">' .
+       $html =
+               Sanitizer::hackDocType() .
                '<html>' .
                $text .
                '</html>';
@@ -1677,7 +1718,7 @@ function wfIsWellFormedXmlFragment( $text ) {
 function wfShellExec( $cmd )
 {
        global $IP;
-       
+
        if ( php_uname( 's' ) == 'Linux' ) {
                $time = ini_get( 'max_execution_time' );
                $mem = ini_get( 'memory_limit' );
@@ -1712,7 +1753,7 @@ function wfShellExec( $cmd )
  */
 function wfUsePHP( $req_ver ) {
        $php_ver = PHP_VERSION;
-       
+
        if ( version_compare( $php_ver, (string)$req_ver, '<' ) )
                 wfDebugDieBacktrace( "PHP $req_ver required--this is only $php_ver" );
 }
@@ -1750,4 +1791,23 @@ function wfRegexReplacement( $string ) {
        return $string;
 }
 
+/**
+ * Return the final portion of a pathname.
+ * Reimplemented because PHP5's basename() is buggy with multibyte text.
+ * http://bugs.php.net/bug.php?id=33898
+ *
+ * PHP's basename() only considers '\' a pathchar on Windows and Netware.
+ * We'll consider it so always, as we don't want \s in our Unix paths either.
+ * 
+ * @param string $path
+ * @return string
+ */
+function wfBaseName( $path ) {
+       if( preg_match( '#([^/\\\\]*)[/\\\\]*$#', $path, $matches ) ) {
+               return $matches[1];
+       } else {
+               return '';
+       }
+}
+
 ?>