* Add form to RCLinked and add to sp:specialpages
[lhc/web/wiklou.git] / includes / ParserCache.php
index 00ed003..129b713 100644 (file)
@@ -1,40 +1,58 @@
 <?php
 /**
  *
- * @package MediaWiki
- */
-
-/**
- *
- * @package MediaWiki
+ * @addtogroup Cache
+ * @todo document
  */
 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 ) {
+       function __construct( &$memCached ) {
                $this->mMemc =& $memCached;
        }
-       
+
        function getKey( &$article, &$user ) {
-               global $wgDBname;
+               global $action;
                $hash = $user->getPageRenderingHash();
+               if( !$article->mTitle->quickUserCan( 'edit' ) ) {
+                       // 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 = wfMemcKey( '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 $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 = $this->mMemc->get( $key );
                if ( is_object( $value ) ) {
@@ -45,37 +63,57 @@ class ParserCache {
                        $touched = $article->mTouched;
                        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" );
                                }
                                $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 $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";
-               wfDebug( "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" );
                }
-               $this->mMemc->set( $key, $parserOutput, $expire );
        }
+
 }
 
 
-?>