* New option $wgPerLanguageCaching, for wikies with many translated system messages...
authorNiklas Laxström <nikerabbit@users.mediawiki.org>
Fri, 23 May 2008 22:14:32 +0000 (22:14 +0000)
committerNiklas Laxström <nikerabbit@users.mediawiki.org>
Fri, 23 May 2008 22:14:32 +0000 (22:14 +0000)
* Sidebar is now cached for all languages

RELEASE-NOTES
includes/GlobalFunctions.php
includes/MessageCache.php
includes/Skin.php
languages/Language.php

index 39a7849..33f455b 100644 (file)
@@ -47,6 +47,8 @@ it from source control: http://www.mediawiki.org/wiki/Download_from_SVN
   image page already exists.
 * $wgMaximumMovedPages restricts the number of pages that can be moved at once
   (default 100) with the new subpage-move functionality of Special:Movepage.
+* New option $wgPerLanguageCaching, for wikies with many translated system
+  messages in MediaWiki namespace.
 
 === New features in 1.13 ===
 
@@ -124,6 +126,7 @@ it from source control: http://www.mediawiki.org/wiki/Download_from_SVN
 * (bug 13232) importScript(), importStylesheet() funcs available to custom JS
 * (bug 13095) Search by first letters or digits in [[Special:Categories]]
 * Users moving a page can now move all subpages automatically as well
+* Sidebar is now cached for all languages
 
 === Bug fixes in 1.13 ===
 
index 4d3c32b..a9bf015 100644 (file)
@@ -2336,6 +2336,14 @@ function wfMemcKey( /*... */ ) {
        return $key;
 }
 
+function wfMemcKeyLang( $key, $code ) {
+       if ( !is_string($code) ) {
+               return $key;
+       } else {
+               return $key . ';L:' . $code;
+       }
+}
+
 /**
  * Get a cache key for a foreign DB
  */
index 9bd3321..a754e03 100644 (file)
@@ -22,8 +22,7 @@ class MessageCache {
        var $mMemcKey, $mKeys, $mParserOptions, $mParser;
        var $mExtensionMessages = array();
        var $mInitialised = false;
-       var $mDeferred = true;
-       var $mAllMessagesLoaded;
+       var $mAllMessagesLoaded; // Extension messages
 
        function __construct( &$memCached, $useDB, $expiry, $memcPrefix) {
                wfProfileIn( __METHOD__ );
@@ -38,15 +37,14 @@ class MessageCache {
                $this->mInitialised = true;
                $this->mParser = null;
 
-               # When we first get asked for a message,
-               # then we'll fill up the cache. If we
-               # can return a cache hit, this saves
-               # some extra milliseconds
-               $this->mDeferred = true;
-
                wfProfileOut( __METHOD__ );
        }
 
+
+       /**
+        * ParserOptions is lazy initialised.
+        * Access should probably be protected.
+        */
        function getParserOptions() {
                if ( !$this->mParserOptions ) {
                        $this->mParserOptions = new ParserOptions;
@@ -55,22 +53,26 @@ class MessageCache {
        }
 
        /**
-        * Try to load the cache from a local file
+        * Try to load the cache from a local file.
+        * Actual format of the file depends on the $wgLocalMessageCacheSerialized
+        * setting.
+        *
+        * @param $hash String: the hash of contents, to check validity.
+        * @param $code Mixed: Optional language code, see documenation of load().
+        * @return false on failure.
         */
-       function loadFromLocal( $hash ) {
+       function loadFromLocal( $hash, $code ) {
                global $wgLocalMessageCache, $wgLocalMessageCacheSerialized;
 
-               if ( $wgLocalMessageCache === false ) {
-                       return;
-               }
-
                $filename = "$wgLocalMessageCache/messages-" . wfWikiID();
+               if ( $code ) $filename .= '-' . $code;
 
+               # Check file existence
                wfSuppressWarnings();
                $file = fopen( $filename, 'r' );
                wfRestoreWarnings();
                if ( !$file ) {
-                       return;
+                       return false; // No cache file
                }
 
                if ( $wgLocalMessageCacheSerialized ) {
@@ -82,35 +84,35 @@ class MessageCache {
                                while ( !feof( $file ) ) {
                                        $serialized .= fread( $file, 100000 );
                                }
-                               $this->setCache( unserialize( $serialized ) );
+                               fclose( $file );
+                               return $this->setCache( unserialize( $serialized ) );
+                       } else {
+                               fclose( $file );
+                               return false; // Wrong hash
                        }
-                       fclose( $file );
                } else {
                        $localHash=substr(fread($file,40),8);
                        fclose($file);
                        if ($hash!=$localHash) {
-                               return;
+                               return false; // Wrong hash
                        }
 
-                       require("$wgLocalMessageCache/messages-" . wfWikiID());
-                       $this->setCache( $this->mCache);
+                       require( $filename );
+                       return $this->setCache( $this->mCache );
                }
        }
 
        /**
         * Save the cache to a local file
         */
-       function saveToLocal( $serialized, $hash ) {
-               global $wgLocalMessageCache, $wgLocalMessageCacheSerialized;
-
-               if ( $wgLocalMessageCache === false ) {
-                       return;
-               }
+       function saveToLocal( $serialized, $hash, $code  ) {
+               global $wgLocalMessageCache;
 
                $filename = "$wgLocalMessageCache/messages-" . wfWikiID();
-               $oldUmask = umask( 0 );
-               wfMkdirParents( $wgLocalMessageCache, 0777 );
-               umask( $oldUmask );
+               if ( $code ) $filename .= '-' . $code;
+
+               # Make sure the directories exist
+               $this->createCacheDir( $wgLocalMessageCache );
 
                $file = fopen( $filename, 'w' );
                if ( !$file ) {
@@ -123,32 +125,39 @@ class MessageCache {
                @chmod( $filename, 0666 );
        }
 
-       function loadFromScript( $hash ) {
-               wfDeprecated( __METHOD__ );
-               $this->loadFromLocal( $hash );
-       }
-
-       function saveToScript($array, $hash) {
+       function saveToScript( $array, $hash, $code ) {
                global $wgLocalMessageCache;
-               if ( $wgLocalMessageCache === false ) {
-                       return;
-               }
 
                $filename = "$wgLocalMessageCache/messages-" . wfWikiID();
-               $oldUmask = umask( 0 );
-               wfMkdirParents( $wgLocalMessageCache, 0777 );
-               umask( $oldUmask );
-               $file = fopen( $filename.'.tmp', 'w');
+               if ( $code ) $filename .= '-' . $code;
+               $tempFilename = $filename . '.tmp';
+
+               # Make sure the directories exist
+               $this->createCacheDir( $wgLocalMessageCache );
+
+               $file = fopen( $tempFilename, 'w');
                fwrite($file,"<?php\n//$hash\n\n \$this->mCache = array(");
 
                foreach ($array as $key => $message) {
-                       fwrite($file, "'". $this->escapeForScript($key).
-                               "' => '" . $this->escapeForScript($message).
-                               "',\n");
+                       $key = $this->escapeForScript($key);
+                       $messages = $this->escapeForScript($message);
+                       fwrite($file, "'$key' => '$message',\n");
                }
+
                fwrite($file,");\n?>");
                fclose($file);
-               rename($filename.'.tmp',$filename);
+               rename($tempFilename, $filename);
+       }
+
+       /**
+        * Creates directory with correct permissions.
+        *
+        * @param $path String: path that is created if it does not exist.
+        */
+       protected function createCacheDir( $path ) {
+               $oldUmask = umask( 0 );
+               wfMkdirParents( $path, 0777 );
+               umask( $oldUmask );
        }
 
        function escapeForScript($string) {
@@ -162,220 +171,320 @@ class MessageCache {
         */
        function setCache( $cache ) {
                if ( isset( $cache['VERSION'] ) && $cache['VERSION'] == MSG_CACHE_VERSION ) {
-                       $this->mCache = $cache;
+                       if ( $this->mCache ) {
+                               $this->mCache = $cache + $this->mCache;
+                       } else {
+                               $this->mCache = $cache;
+                       }
+                       return true;
                } else {
-                       $this->mCache = false;
+                       return false;
                }
        }
 
        /**
-        * Loads messages either from memcached or the database, if not disabled
-        * On error, quietly switches to a fallback mode
-        * Returns false for a reportable error, true otherwise
+        * Loads messages from caches or from database in this order:
+        * (1) local message cache (if $wgLocalMessageCache is enabled)
+        * (2) memcached
+        * (3) from the database.
+        *
+        * When succesfully loading from (2) or (3), all higher level caches are
+        * updated for the newest version.
+        *
+        * Nothing is loaded if  member variable mDisabled is true, either manually
+        * set by calling code or if message loading fails (is this possible?).
+        *
+        * Returns true if cache is already populated or it was succesfully populated,
+        * or false if populating empty cache fails. Also returns true if MessageCache
+        * is disabled.
+        *
+        * @param $code Mixed: if evaluates to false, messages for all languages is
+        *              loaded and stored in cache as one object. If code is provided
+        *              and $wgPerLanguageCaching is true, messages are loaded per
+        *              language and stored individually in caches 1 to 2.
         */
-       function load() {
-               global $wgLocalMessageCache, $wgLocalMessageCacheSerialized;
+       function load( $code = false ) {
+               global $wgLocalMessageCache, $wgPerLanguageCaching;
+
+               if ( !$this->mUseCache ) {
+                       return true;
+               }
+
+               # Keep track of loaded messages. Either array of loaded codes as keys,
+               # or just true if all languages are loaded.
+               static $loaded = false;
+
+               if ( !$wgPerLanguageCaching ) {
+                       // Disable language separation for normal use case
+                       $code = false;
+               } elseif( !is_string( $code ) ) {
+                       # This isn't really nice, so at least make a note about it
+                       wfDebug( __METHOD__ . " called without providing a language code\n" );
+               }
+
+               # Don't do double loading...
+               if ( $loaded === true || ($code && isset($loaded[$code])) ) return true;
+
+               # Adjust cache key if we are handling only single language
+               $cacheKey = wfMemcKeyLang( $this->mMemcKey, $code );
 
+               # 8 lines of code just to say (once) that message cache is disabled
                if ( $this->mDisable ) {
                        static $shownDisabled = false;
                        if ( !$shownDisabled ) {
-                               wfDebug( "MessageCache::load(): disabled\n" );
+                               wfDebug( __METHOD__ . ": disabled\n" );
                                $shownDisabled = true;
                        }
                        return true;
                }
-               if ( !$this->mUseCache ) {
-                       $this->mDeferred = false;
-                       return true;
-               }
-
-               $fname = 'MessageCache::load';
-               wfProfileIn( $fname );
-               $success = true;
 
-               $this->mCache = false;
+               # Loading code starts
+               wfProfileIn( __METHOD__ );
+               $success = false; # Keep track of success
+               $where = array(); # Debug info, delayed to avoid spamming debug log too much
 
-               # Try local cache
+               # (1) local cache
+               # Hash of the contents is stored in memcache, to detect if local cache goes
+               # out of date (due to update in other thread?)
                if ( $wgLocalMessageCache !== false ) {
-                       wfProfileIn( $fname.'-fromlocal' );
-                       $hash = $this->mMemc->get( "{$this->mMemcKey}-hash" );
+                       wfProfileIn( __METHOD__ . '-fromlocal' );
+                       $hash = $this->mMemc->get( "$cacheKey-hash" );
                        if ( $hash ) {
-                               $this->loadFromLocal( $hash );
-                               if ( $this->mCache ) {
-                                       wfDebug( "MessageCache::load(): got from local cache\n" );
-                               }
+                               $success = $this->loadFromLocal( $hash, $code );
+                               if ( $success ) $where[] = 'got from local cache';
                        }
-                       wfProfileOut( $fname.'-fromlocal' );
+                       wfProfileOut( __METHOD__ . '-fromlocal' );
                }
 
-               # Try memcached
-               if ( !$this->mCache ) {
-                       wfProfileIn( $fname.'-fromcache' );
-                       $this->setCache( $this->mMemc->get( $this->mMemcKey ) );
-                       if ( $this->mCache ) {
-                               wfDebug( "MessageCache::load(): got from global cache\n" );
-                               # Save to local cache
-                               if ( $wgLocalMessageCache !== false ) {
-                                       $serialized = serialize( $this->mCache );
-                                       if ( !$hash ) {
-                                               $hash = md5( $serialized );
-                                               $this->mMemc->set( "{$this->mMemcKey}-hash", $hash, $this->mExpiry );
-                                       }
-                                       if ($wgLocalMessageCacheSerialized) {
-                                               $this->saveToLocal( $serialized,$hash );
-                                       } else {
-                                               $this->saveToScript( $this->mCache, $hash );
-                                       }
-                               }
+               # (2) memcache
+               # Fails if nothing in cache, or in the wrong version.
+               if ( !$success ) {
+                       wfProfileIn( __METHOD__ . '-fromcache' );
+                       $cache = $this->mMemc->get( $cacheKey );
+                       $success = $this->setCache( $cache );
+                       if ( $success ) {
+                               $where[] = 'got from global cache';
+                               $this->saveToCaches( $cache, $cacheKey, false );
                        }
-                       wfProfileOut( $fname.'-fromcache' );
-               }
-
-
-               # If there's nothing in memcached, load all the messages from the database
-               if ( !$this->mCache ) {
-                       wfDebug( "MessageCache::load(): cache is empty\n" );
-                       $this->lock();
-                       # Other threads don't need to load the messages if another thread is doing it.
-                       $success = $this->mMemc->add( $this->mMemcKey.'-status', "loading", MSG_LOAD_TIMEOUT );
+                       wfProfileOut( __METHOD__ . '-fromcache' );
+               }
+
+
+               # (3)
+               # Nothing in caches... so we need create one and store it in caches
+               if ( !$success ) {
+                       $where[] = 'cache is empty';
+                       $this->lock($cacheKey);
+                       wfProfileIn( __METHOD__ . '-load' );
+                       $where[] = 'loading from database';
+                       # We want to store messages of particular language here, not everything
+                       # from mCache.
+                       $cache = $this->loadFromDB( $code );
+                       $success = $this->setCache( $cache );
+                       wfProfileOut( __METHOD__ . '-load' );
                        if ( $success ) {
-                               wfProfileIn( $fname.'-load' );
-                               wfDebug( "MessageCache::load(): loading all messages from DB\n" );
-                               $this->loadFromDB();
-                               wfProfileOut( $fname.'-load' );
-
-                               # Save in memcached
-                               # Keep trying if it fails, this is kind of important
-                               wfProfileIn( $fname.'-save' );
-                               for ($i=0; $i<20 &&
-                                                  !$this->mMemc->set( $this->mMemcKey, $this->mCache, $this->mExpiry );
-                                        $i++ ) {
-                                       usleep(mt_rand(500000,1500000));
-                               }
-
-                               # Save to local cache
-                               if ( $wgLocalMessageCache !== false ) {
-                                       $serialized = serialize( $this->mCache );
-                                       $hash = md5( $serialized );
-                                       $this->mMemc->set( "{$this->mMemcKey}-hash", $hash, $this->mExpiry );
-                                       if ($wgLocalMessageCacheSerialized) {
-                                               $this->saveToLocal( $serialized,$hash );
-                                       } else {
-                                               $this->saveToScript( $this->mCache, $hash );
-                                       }
-                               }
-
-                               wfProfileOut( $fname.'-save' );
-                               if ( $i == 20 ) {
-                                       $this->mMemc->set( $this->mMemcKey.'-status', 'error', 60*5 );
-                                       wfDebug( "MemCached set error in MessageCache: restart memcached server!\n" );
-                               } else {
-                                       $this->mMemc->delete( $this->mMemcKey.'-status' );
-                               }
+                               $this->saveToCaches( $cache, $cacheKey );
                        }
-                       $this->unlock();
+                       $this->unlock($cacheKey);
                }
 
-               if ( !is_array( $this->mCache ) ) {
-                       wfDebug( "MessageCache::load(): unable to load cache, disabled\n" );
+               if ( !$success ) {
+                       # Bad luck... this should not happen
+                       $where[] = 'loading FAILED - cache is disabled';
+                       $info = implode( ', ', $where );
+                       wfDebug( __METHOD__ . ": Loading $code... $info\n" );
                        $this->mDisable = true;
                        $this->mCache = false;
+               } else {
+                       # All good, just record the success
+                       $info = implode( ', ', $where );
+                       wfDebug( __METHOD__ . ": Loading $code... $info\n" );
+                       if ( $code ) {
+                               $loaded[$code] = true;
+                       } else {
+                               $loaded = true;
+                       }
                }
-               wfProfileOut( $fname );
-               $this->mDeferred = false;
+               wfProfileOut( __METHOD__ );
                return $success;
        }
 
        /**
-        * Loads all or main part of cacheable messages from the database
+        * Loads cacheable messages from the database. Messages bigger than
+        * $wgMaxMsgCacheEntrySize are assigned a special value, and are loaded
+        * on-demand from the database later.
+        *
+        * @param $code Optional language code, see documenation of load().
+        * @return Array: Loaded messages for storing in caches.
         */
-       function loadFromDB() {
-               global $wgMaxMsgCacheEntrySize;
-
+       function loadFromDB( $code = false ) {
                wfProfileIn( __METHOD__ );
+               global $wgMaxMsgCacheEntrySize, $wgContLanguageCode;
                $dbr = wfGetDB( DB_SLAVE );
-               $this->mCache = array();
+               $cache = array();
+
+               # Common conditions
+               $conds = array(
+                       'page_is_redirect' => 0,
+                       'page_namespace' => NS_MEDIAWIKI,
+               );
+
+               if ( $code ) {
+                       # Should $code be escaped?
+                       # Is this fast enough. Should not matter if the filtering is done in the
+                       # database or in code.
+                       if ( $code !== $wgContLanguageCode ) {
+                               # Messages for particular language
+                               $conds[] = "page_title like '%%/$code'";
+                       } else {
+                               # Effectively disallows use of '/' character in NS_MEDIAWIKI for uses
+                               # other than language code.
+                               $conds[] = "page_title not like '%%/%%'";
+                       }
+               }
+
+               # Conditions to fetch oversized pages to ignore them
+               $bigConds = $conds;
+               $bigConds[] = 'page_len > ' . intval( $wgMaxMsgCacheEntrySize );
 
                # Load titles for all oversized pages in the MediaWiki namespace
-               $res = $dbr->select( 'page', 'page_title',
-                       array(
-                               'page_len > ' . intval( $wgMaxMsgCacheEntrySize ),
-                               'page_is_redirect' => 0,
-                               'page_namespace' => NS_MEDIAWIKI,
-                       ),
-                       __METHOD__ );
+               $res = $dbr->select( 'page', 'page_title', $bigConds, __METHOD__ );
                while ( $row = $dbr->fetchObject( $res ) ) {
-                       $this->mCache[$row->page_title] = '!TOO BIG';
+                       $cache[$row->page_title] = '!TOO BIG';
                }
                $dbr->freeResult( $res );
 
-               # Load text for the remaining pages
+               # Conditions to load the remaining pages with their contents
+               $smallConds = $conds;
+               $smallConds[] = 'page_latest=rev_id';
+               $smallConds[] = 'rev_text_id=old_id';
+               $smallConds[] = 'page_len <= ' . intval( $wgMaxMsgCacheEntrySize );
+
                $res = $dbr->select( array( 'page', 'revision', 'text' ),
                        array( 'page_title', 'old_text', 'old_flags' ),
-                       array(
-                               'page_is_redirect' => 0,
-                               'page_namespace' => NS_MEDIAWIKI,
-                               'page_latest=rev_id',
-                               'rev_text_id=old_id',
-                               'page_len <= ' . intval( $wgMaxMsgCacheEntrySize ) ),
-                       __METHOD__ );
+                       $smallConds, __METHOD__ );
 
                for ( $row = $dbr->fetchObject( $res ); $row; $row = $dbr->fetchObject( $res ) ) {
-                       $this->mCache[$row->page_title] = ' ' . Revision::getRevisionText( $row );
+                       $cache[$row->page_title] = ' ' . Revision::getRevisionText( $row );
                }
-               $this->mCache['VERSION'] = MSG_CACHE_VERSION;
                $dbr->freeResult( $res );
+
+               $cache['VERSION'] = MSG_CACHE_VERSION;
                wfProfileOut( __METHOD__ );
+               return $cache;
        }
 
-       function replace( $title, $text ) {
-               global $wgLocalMessageCache, $wgLocalMessageCacheSerialized, $parserMemc;
-               global $wgMaxMsgCacheEntrySize;
+       /**
+        * Updates cache as necessary when message page is changed
+        *
+        * @param $title String: name of the page changed.
+        * @param $text Mixed: new contents of the page.
+        */
+       public function replace( $title, $text ) {
+               global $wgMaxMsgCacheEntrySize, $wgPerLanguageCaching;
+
+               list( $message, $code ) = $this->figureMessage( $title );
+
+               # TODO: Should we define the sidebar key name somewhere?
+               $sidebarKey = wfMemcKeyLang( 'sidebar' , $code );
+
+               # Load only messages for affected language, if possible
+               if ( !$wgPerLanguageCaching ) $code = false;
+               $cacheKey = wfMemcKeyLang( $this->mMemcKey, $code );
 
                wfProfileIn( __METHOD__ );
-               $this->lock();
-               $this->load();
-               if ( is_array( $this->mCache ) ) {
+               $this->lock($cacheKey);
+
+               $cache = $this->mMemc->get( $cacheKey );
+               if ( is_array( $cache ) ) {
                        if ( $text === false ) {
                                # Article was deleted
                                unset( $this->mCache[$title] );
                                $this->mMemc->delete( "$this->mMemcKey:{$title}" );
                        } elseif ( strlen( $text ) > $wgMaxMsgCacheEntrySize ) {
-                               $this->mCache[$title] = '!TOO BIG';
+                               $cache[$title] = $this->mCache[$title] = '!TOO BIG';
                                $this->mMemc->set( "$this->mMemcKey:{$title}", ' '.$text, $this->mExpiry );
                        } else {
-                               $this->mCache[$title] = ' ' . $text;
+                               $cache[$title] = $this->mCache[$title] = ' ' . $text;
                                $this->mMemc->delete( "$this->mMemcKey:{$title}" );
                        }
-                       $this->mMemc->set( $this->mMemcKey, $this->mCache, $this->mExpiry );
-
-                       # Save to local cache
-                       if ( $wgLocalMessageCache !== false ) {
-                               $serialized = serialize( $this->mCache );
-                               $hash = md5( $serialized );
-                               $this->mMemc->set( "{$this->mMemcKey}-hash", $hash, $this->mExpiry );
-                               if ($wgLocalMessageCacheSerialized) {
-                                       $this->saveToLocal( $serialized,$hash );
-                               } else {
-                                       $this->saveToScript( $this->mCache, $hash );
-                               }
+
+                       # Update per-request cache
+                       $success = $this->setCache( $cache, $cacheKey );
+                       if ( $success ) {
+                               # And then all caches
+                               $this->saveToCaches( $cache, $cacheKey );
+                       }
+               }
+               $this->unlock($cacheKey);
+
+               // Also delete cached sidebar... just in case it is affected
+               global $parserMemc;
+               $parserMemc->delete( $sidebarKey );
+               wfProfileOut( __METHOD__ );
+       }
+
+       /**
+        * Shortcut to update caches.
+        *
+        * @param $cache Array: cached messages with a version.
+        * @param $cacheKey String: Identifier for the cache.
+        * @param $memc Bool: Wether to update or not memcache.
+        * @return False on somekind of error.
+        */
+       protected function saveToCaches( $cache, $cacheKey, $memc = true ) {
+               wfProfileIn( __METHOD__ );
+               global $wgLocalMessageCache, $wgLocalMessageCacheSerialized;
+
+               $success = $this->mMemc->add( $cacheKey.'-status', "loading", MSG_LOAD_TIMEOUT );
+               if ( !$success ) return true; # Other process should be updating them now
+
+               $i = 0;
+               if ( $memc ) {
+                       # Save in memcached
+                       # Keep trying if it fails, this is kind of important
+
+                       for ($i=0; $i<20 &&
+                                                       !$this->mMemc->set( $cacheKey, $cache, $this->mExpiry );
+                                       $i++ ) {
+                               usleep(mt_rand(500000,1500000));
+                       }
+               }
+
+               # Save to local cache
+               if ( $wgLocalMessageCache !== false ) {
+                       $serialized = serialize( $cache );
+                       $hash = md5( $serialized );
+                       $this->mMemc->set( "$cacheKey-hash", $hash, $this->mExpiry );
+                       if ($wgLocalMessageCacheSerialized) {
+                               $this->saveToLocal( $serialized, $hash, $code );
+                       } else {
+                               $this->saveToScript( $cache, $hash, $code );
                        }
                }
-               $this->unlock();
-               $parserMemc->delete(wfMemcKey('sidebar'));
+
+               if ( $i == 20 ) {
+                       $this->mMemc->set( $cacheKey.'-status', 'error', 60*5 );
+                       wfDebug( "MemCached set error in MessageCache: restart memcached server!\n" );
+                       $success = false;
+               } else {
+                       $this->mMemc->delete( $cacheKey.'-status' );
+                       $success = true;
+               }
                wfProfileOut( __METHOD__ );
+               return $success;
        }
 
        /**
         * Returns success
         * Represents a write lock on the messages key
         */
-       function lock() {
+       function lock($key) {
                if ( !$this->mUseCache ) {
                        return true;
                }
 
-               $lockKey = $this->mMemcKey . 'lock';
+               $lockKey = $key . 'lock';
                for ($i=0; $i < MSG_WAIT_TIMEOUT && !$this->mMemc->add( $lockKey, 1, MSG_LOCK_TIMEOUT ); $i++ ) {
                        sleep(1);
                }
@@ -383,12 +492,12 @@ class MessageCache {
                return $i >= MSG_WAIT_TIMEOUT;
        }
 
-       function unlock() {
+       function unlock($key) {
                if ( !$this->mUseCache ) {
                        return;
                }
 
-               $lockKey = $this->mMemcKey . 'lock';
+               $lockKey = $key . 'lock';
                $this->mMemc->delete( $lockKey );
        }
 
@@ -438,10 +547,6 @@ class MessageCache {
                if( !$this->mInitialised ) {
                        return '&lt;' . htmlspecialchars($key) . '&gt;';
                }
-               # If cache initialization was deferred, start it now.
-               if( $this->mDeferred && !$this->mDisable && $useDB ) {
-                       $this->load();
-               }
 
                $message = false;
 
@@ -455,10 +560,11 @@ class MessageCache {
                        if(!$isFullKey && ($langcode != $wgContLanguageCode) ) {
                                $title .= '/' . $langcode;
                        }
-                       $message = $this->getMsgFromNamespace( $title );
+                       $message = $this->getMsgFromNamespace( $title, $langcode );
                }
+
                # Try the extension array
-               if( $message === false && isset( $this->mExtensionMessages[$langcode][$lckey] ) ) {
+               if ( $message === false && isset( $this->mExtensionMessages[$langcode][$lckey] ) ) {
                        $message = $this->mExtensionMessages[$langcode][$lckey];
                }
                if ( $message === false && isset( $this->mExtensionMessages['en'][$lckey] ) ) {
@@ -466,11 +572,8 @@ class MessageCache {
                }
 
                # Try the array in the language object
-               if( $message === false ) {
-                       #wfDebug( "Trying language object for message $key\n" );
-                       wfSuppressWarnings();
+               if ( $message === false ) {
                        $message = $lang->getMessage( $lckey );
-                       wfRestoreWarnings();
                        if ( is_null( $message ) ) {
                                $message = false;
                        }
@@ -498,7 +601,7 @@ class MessageCache {
                if( ($message === false || $message === '-' ) &&
                        !$this->mDisable && $useDB &&
                        !$isFullKey && ($langcode != $wgContLanguageCode) ) {
-                       $message = $this->getMsgFromNamespace( $wgContLang->ucfirst( $lckey ) );
+                       $message = $this->getMsgFromNamespace( $wgContLang->ucfirst( $lckey ), $wgContLanguageCode );
                }
 
                # Final fallback
@@ -512,18 +615,25 @@ class MessageCache {
         * Get a message from the MediaWiki namespace, with caching. The key must
         * first be converted to two-part lang/msg form if necessary.
         *
-        * @param string $title Message cache key with initial uppercase letter
+        * @param $title String: Message cache key with initial uppercase letter.
+        * @param $code String: code denoting the language to try.
         */
-       function getMsgFromNamespace( $title ) {
+       function getMsgFromNamespace( $title, $code ) {
                $message = false;
                $type = false;
 
-               # Try the cache
-               if( $this->mUseCache && isset( $this->mCache[$title] ) ) {
-                       $entry = $this->mCache[$title];
-                       $type = substr( $entry, 0, 1 );
-                       if ( $type == ' ' ) {
-                               return substr( $entry, 1 );
+               if ( $this->mUseCache ) {
+                       if ( !isset($this->mCache[$title]) ) {
+                               # Delay loading as far as possible, and only load messages for requested
+                               # language.
+                               $this->load( $code );
+                       }
+                       if (isset( $this->mCache[$title] ) ) {
+                               $entry = $this->mCache[$title];
+                               $type = substr( $entry, 0, 1 );
+                               if ( $type == ' ' ) {
+                                       return substr( $entry, 1 );
+                               }
                        }
                }
 
@@ -547,6 +657,7 @@ class MessageCache {
                                $type = substr( $entry, 0, 1 );
 
                                if ( $type == ' ' ) {
+                                       # Ok!
                                        $message = substr( $entry, 1 );
                                        $this->mCache[$title] = $entry;
                                        return $message;
@@ -574,7 +685,6 @@ class MessageCache {
                        $this->mMemc->set( $memcKey, '!NONEXISTENT', $this->mExpiry );
                        $this->mCache[$title] = false;
                }
-
                return $message;
        }
 
@@ -598,7 +708,7 @@ class MessageCache {
 
        function disable() { $this->mDisable = true; }
        function enable() { $this->mDisable = false; }
-
        /** @deprecated */
        function disableTransform(){
                wfDeprecated( __METHOD__ );
@@ -761,4 +871,15 @@ class MessageCache {
                        $this->addMessages( $mergedMessages, $langcode );
        }
 
+       public function figureMessage( $key ) {
+               global $wgContLanguageCode;
+               $pieces = explode('/', $key, 2);
+
+               $key = $pieces[0];
+
+               # Language the user is translating to
+               $langCode = isset($pieces[1]) ? $pieces[1] : $wgContLanguageCode;
+               return array( $key, $langCode );
+       }
+
 }
index e2e9a32..c5399e5 100644 (file)
@@ -1650,24 +1650,18 @@ END;
         * Build an array that represents the sidebar(s), the navigation bar among them
         *
         * @return array
-        * @private
         */
        function buildSidebar() {
                global $parserMemc, $wgEnableSidebarCache, $wgSidebarCacheExpiry;
-               global $wgLang, $wgContLang;
-
-               $fname = 'SkinTemplate::buildSidebar';
-
-               wfProfileIn( $fname );
+               global $wgLang;
+               wfProfileIn( __METHOD__ );
 
-               $key = wfMemcKey( 'sidebar' );
-               $cacheSidebar = $wgEnableSidebarCache &&
-                       ($wgLang->getCode() == $wgContLang->getCode());
+               $key = wfMemcKeyLang( wfMemcKey( 'sidebar' ), $wgLang->getCode() );
 
-               if ($cacheSidebar) {
+               if ( $wgEnableSidebarCache ) {
                        $cachedsidebar = $parserMemc->get( $key );
-                       if ($cachedsidebar!="") {
-                               wfProfileOut($fname);
+                       if ( $cachedsidebar ) {
+                               wfProfileOut( __METHOD__ );
                                return $cachedsidebar;
                        }
                }
@@ -1683,7 +1677,7 @@ END;
                                $heading = $line;
                        } else {
                                if (strpos($line, '|') !== false) { // sanity check
-                                       $line = explode( '|' , trim($line, '* '), 2 );
+                                       $line = array_map('trim', explode( '|' , trim($line, '* '), 2 ) );
                                        $link = wfMsgForContent( $line[0] );
                                        if ($link == '-')
                                                continue;
@@ -1713,9 +1707,9 @@ END;
                                } else { continue; }
                        }
                }
-               if ($cacheSidebar)
-                       $parserMemc->set( $key, $bar, $wgSidebarCacheExpiry );
-               wfProfileOut( $fname );
+               if ( $wgEnableSidebarCache ) $parserMemc->set( $key, $bar, $wgSidebarCacheExpiry );
+               wfProfileOut( __METHOD__ );
                return $bar;
        }
 }
+
index 8f2ed96..7ff746b 100644 (file)
@@ -2093,8 +2093,9 @@ class Language {
                        }
 
                        # Try the global cache
-                       $memcKey = wfMemcKey('localisation', $code );
-                       $fbMemcKey = wfMemcKey('fallback', $cache['fallback'] );
+                       
+                       $memcKey = wfMemcKeyLang( wfMemcKey('localisation'), $code );
+                       $fbMemcKey = wfMemcKeyLang( wfMemcKey('fallback'), $cache['fallback'] );
                        $cache = $wgMemc->get( $memcKey );
                        if ( $cache ) {
                                if ( self::isLocalisationOutOfDate( $cache ) ) {
@@ -2232,7 +2233,7 @@ class Language {
 
                // Try memcache
                global $wgMemc;
-               $memcKey = wfMemcKey( 'fallback', $code );
+               $memcKey = wfMemcKeyLang( wfMemcKey('fallback'), $code );
                $fbcode = $wgMemc->get( $memcKey );
 
                if ( is_string($fbcode) ) {