* Non-working API to facilitate dev collaboration. Do not enable this yet in localset...

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

diff --git a/includes/ParserCache.php b/includes/ParserCache.php
index ed4384d..612790a 100644 (file)
--- a/includes/ParserCache.php
+++ b/includes/ParserCache.php
@@ -2,73 +2,126 @@
 /**
  *
  * @package MediaWiki
+ * @subpackage Cache
  */
 
 /**
  *
  * @package MediaWiki
  */
-class ParserCache
-{
+class ParserCache {
+       /**
+        * Get an instance of this object
+        */
+       public static function &singleton() {
+               static $instance;
+               if ( !isset( $instance ) ) {
+                       global $parserMemc;
+                       $instance = new ParserCache( $parserMemc );
+               }
+               return $instance;
+       }
+
+       /**
+        * Setup a cache pathway with a given back-end storage mechanism.
+        * May be a memcached client or a BagOStuff derivative.
+        *
+        * @param object $memCached
+        */
+       function ParserCache( &$memCached ) {
+               $this->mMemc =& $memCached;
+       }
+
        function getKey( &$article, &$user ) {
-               global $wgDBname;
+               global $wgDBname, $action;
                $hash = $user->getPageRenderingHash();
+               if( !$article->mTitle->userCanEdit() ) {
+                       // section edit links are suppressed even if the user has them on
+                       $edit = '!edit=0';
+               } else {
+                       $edit = '';
+               }
                $pageid = intval( $article->getID() );
-               $key = "$wgDBname:pcache:idhash:$pageid-$hash";
+               $renderkey = (int)($action == 'render');
+               $key = "$wgDBname:pcache:idhash:$pageid-$renderkey!$hash$edit";
                return $key;
        }
-       
+
+       function getETag( &$article, &$user ) {
+               return 'W/"' . $this->getKey($article, $user) . "--" . $article->mTouched. '"';
+       }
+
        function get( &$article, &$user ) {
-               global $wgMemc, $wgCacheEpoch;
+               global $wgCacheEpoch;
                $fname = 'ParserCache::get';
                wfProfileIn( $fname );
 
                $hash = $user->getPageRenderingHash();
                $pageid = intval( $article->getID() );
                $key = $this->getKey( $article, $user );
+
                wfDebug( "Trying parser cache $key\n" );
-               $value = $wgMemc->get( $key );
+               $value = $this->mMemc->get( $key );
                if ( is_object( $value ) ) {
                        wfDebug( "Found.\n" );
                        # Delete if article has changed since the cache was made
                        $canCache = $article->checkTouched();
                        $cacheTime = $value->getCacheTime();
                        $touched = $article->mTouched;
-                       if ( !$canCache || $value->getCacheTime() <= $touched || $cacheTime < $wgCacheEpoch ) {
+                       if ( !$canCache || $value->expired( $touched ) ) {
                                if ( !$canCache ) {
+                                       wfIncrStats( "pcache_miss_invalid" );
                                        wfDebug( "Invalid cached redirect, touched $touched, epoch $wgCacheEpoch, cached $cacheTime\n" );
                                } else {
+                                       wfIncrStats( "pcache_miss_expired" );
                                        wfDebug( "Key expired, touched $touched, epoch $wgCacheEpoch, cached $cacheTime\n" );
                                }
-                               $wgMemc->delete( $key );
+                               $this->mMemc->delete( $key );
                                $value = false;
+                       } else {
+                               if ( isset( $value->mTimestamp ) ) {
+                                       $article->mTimestamp = $value->mTimestamp;
+                               }
+                               wfIncrStats( "pcache_hit" );
                        }
                } else {
                        wfDebug( "Parser cache miss.\n" );
+                       wfIncrStats( "pcache_miss_absent" );
                        $value = false;
                }
 
                wfProfileOut( $fname );
                return $value;
        }
-       
-       function save( $parserOutput, &$article, &$user ){
-               global $wgMemc;
 
+       function save( $parserOutput, &$article, &$user ){
+               global $wgParserCacheExpireTime;
                $key = $this->getKey( $article, $user );
-               $now = wfTimestampNow();
-               $parserOutput->setCacheTime( $now );
-               $parserOutput->mText .= "\n<!-- Saved in parser cache with key $key and timestamp $now -->\n";
-
-               if( $parserOutput->containsOldMagic() ){
-                       $expire = 3600; # 1 hour
+               
+               if( $parserOutput->getCacheTime() != -1 ) {
+               
+                       $now = wfTimestampNow();
+                       $parserOutput->setCacheTime( $now );
+       
+                       // Save the timestamp so that we don't have to load the revision row on view
+                       $parserOutput->mTimestamp = $article->getTimestamp();
+                       
+                       $parserOutput->mText .= "\n<!-- Saved in parser cache with key $key and timestamp $now -->\n";
+                       wfDebug( "Saved in parser cache with key $key and timestamp $now\n" );
+       
+                       if( $parserOutput->containsOldMagic() ){
+                               $expire = 3600; # 1 hour
+                       } else {
+                               $expire = $wgParserCacheExpireTime;
+                       }
+                       $this->mMemc->set( $key, $parserOutput, $expire );
+               
                } else {
-                       $expire = 86400; # 1 day
+                       wfDebug( "Parser output was marked as uncacheable and has not been saved.\n" );
                }
-
-               $wgMemc->set( $key, $parserOutput, $expire );
+               
        }
+       
 }
 
-
 ?>