includes/poolcounter/PoolWorkArticleView.php

   1 <?php
   2 /**
   3  * This program is free software; you can redistribute it and/or modify
   4  * it under the terms of the GNU General Public License as published by
   5  * the Free Software Foundation; either version 2 of the License, or
   6  * (at your option) any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along
  14  * with this program; if not, write to the Free Software Foundation, Inc.,
  15  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  16  * http://www.gnu.org/copyleft/gpl.html
  17  *
  18  * @file
  19  */
  20
  21 class PoolWorkArticleView extends PoolCounterWork {
  22         /** @var WikiPage */
  23         private $page;
  24
  25         /** @var string */
  26         private $cacheKey;
  27
  28         /** @var int */
  29         private $revid;
  30
  31         /** @var ParserOptions */
  32         private $parserOptions;
  33
  34         /** @var Content|null */
  35         private $content = null;
  36
  37         /** @var ParserOutput|bool */
  38         private $parserOutput = false;
  39
  40         /** @var bool */
  41         private $isDirty = false;
  42
  43         /** @var Status|bool */
  44         private $error = false;
  45
  46         /**
  47          * @param WikiPage $page
  48          * @param ParserOptions $parserOptions ParserOptions to use for the parse
  49          * @param int $revid ID of the revision being parsed.
  50          * @param bool $useParserCache Whether to use the parser cache.
  51          *   operation.
  52          * @param Content|string $content Content to parse or null to load it; may
  53          *   also be given as a wikitext string, for BC.
  54          */
  55         public function __construct( WikiPage $page, ParserOptions $parserOptions,
  56                 $revid, $useParserCache, $content = null
  57         ) {
  58                 if ( is_string( $content ) ) { // BC: old style call
  59                         $modelId = $page->getRevision()->getContentModel();
  60                         $format = $page->getRevision()->getContentFormat();
  61                         $content = ContentHandler::makeContent( $content, $page->getTitle(), $modelId, $format );
  62                 }
  63
  64                 $this->page = $page;
  65                 $this->revid = $revid;
  66                 $this->cacheable = $useParserCache;
  67                 $this->parserOptions = $parserOptions;
  68                 $this->content = $content;
  69                 $this->cacheKey = ParserCache::singleton()->getKey( $page, $parserOptions );
  70                 $keyPrefix = $this->cacheKey ?: wfMemcKey( 'articleview', 'missingcachekey' );
  71                 parent::__construct( 'ArticleView', $keyPrefix . ':revid:' . $revid );
  72         }
  73
  74         /**
  75          * Get the ParserOutput from this object, or false in case of failure
  76          *
  77          * @return ParserOutput
  78          */
  79         public function getParserOutput() {
  80                 return $this->parserOutput;
  81         }
  82
  83         /**
  84          * Get whether the ParserOutput is a dirty one (i.e. expired)
  85          *
  86          * @return bool
  87          */
  88         public function getIsDirty() {
  89                 return $this->isDirty;
  90         }
  91
  92         /**
  93          * Get a Status object in case of error or false otherwise
  94          *
  95          * @return Status|bool
  96          */
  97         public function getError() {
  98                 return $this->error;
  99         }
 100
 101         /**
 102          * @return bool
 103          */
 104         public function doWork() {
 105                 global $wgUseFileCache;
 106
 107                 // @todo several of the methods called on $this->page are not declared in Page, but present
 108                 //        in WikiPage and delegated by Article.
 109
 110                 $isCurrent = $this->revid === $this->page->getLatest();
 111
 112                 if ( $this->content !== null ) {
 113                         $content = $this->content;
 114                 } elseif ( $isCurrent ) {
 115                         // XXX: why use RAW audience here, and PUBLIC (default) below?
 116                         $content = $this->page->getContent( Revision::RAW );
 117                 } else {
 118                         $rev = Revision::newFromTitle( $this->page->getTitle(), $this->revid );
 119
 120                         if ( $rev === null ) {
 121                                 $content = null;
 122                         } else {
 123                                 // XXX: why use PUBLIC audience here (default), and RAW above?
 124                                 $content = $rev->getContent();
 125                         }
 126                 }
 127
 128                 if ( $content === null ) {
 129                         return false;
 130                 }
 131
 132                 // Reduce effects of race conditions for slow parses (bug 46014)
 133                 $cacheTime = wfTimestampNow();
 134
 135                 $time = - microtime( true );
 136                 $this->parserOutput = $content->getParserOutput(
 137                         $this->page->getTitle(),
 138                         $this->revid,
 139                         $this->parserOptions
 140                 );
 141                 $time += microtime( true );
 142
 143                 // Timing hack
 144                 if ( $time > 3 ) {
 145                         // TODO: Use Parser's logger (once it has one)
 146                         $logger = MediaWiki\Logger\LoggerFactory::getInstance( 'slow-parse' );
 147                         $logger->info( '{time} {title}', [
 148                                 'time' => number_format( $time, 2 ),
 149                                 'title' => $this->page->getTitle()->getPrefixedDBkey(),
 150                                 'ns' => $this->page->getTitle()->getNamespace(),
 151                                 'trigger' => 'view',
 152                         ] );
 153                 }
 154
 155                 if ( $this->cacheable && $this->parserOutput->isCacheable() && $isCurrent ) {
 156                         ParserCache::singleton()->save(
 157                                 $this->parserOutput, $this->page, $this->parserOptions, $cacheTime, $this->revid );
 158                 }
 159
 160                 // Make sure file cache is not used on uncacheable content.
 161                 // Output that has magic words in it can still use the parser cache
 162                 // (if enabled), though it will generally expire sooner.
 163                 if ( !$this->parserOutput->isCacheable() ) {
 164                         $wgUseFileCache = false;
 165                 }
 166
 167                 if ( $isCurrent ) {
 168                         $this->page->triggerOpportunisticLinksUpdate( $this->parserOutput );
 169                 }
 170
 171                 return true;
 172         }
 173
 174         /**
 175          * @return bool
 176          */
 177         public function getCachedWork() {
 178                 $this->parserOutput = ParserCache::singleton()->get( $this->page, $this->parserOptions );
 179
 180                 if ( $this->parserOutput === false ) {
 181                         wfDebug( __METHOD__ . ": parser cache miss\n" );
 182                         return false;
 183                 } else {
 184                         wfDebug( __METHOD__ . ": parser cache hit\n" );
 185                         return true;
 186                 }
 187         }
 188
 189         /**
 190          * @return bool
 191          */
 192         public function fallback() {
 193                 $this->parserOutput = ParserCache::singleton()->getDirty( $this->page, $this->parserOptions );
 194
 195                 if ( $this->parserOutput === false ) {
 196                         wfDebugLog( 'dirty', 'dirty missing' );
 197                         wfDebug( __METHOD__ . ": no dirty cache\n" );
 198                         return false;
 199                 } else {
 200                         wfDebug( __METHOD__ . ": sending dirty output\n" );
 201                         wfDebugLog( 'dirty', "dirty output {$this->cacheKey}" );
 202                         $this->isDirty = true;
 203                         return true;
 204                 }
 205         }
 206
 207         /**
 208          * @param Status $status
 209          * @return bool
 210          */
 211         public function error( $status ) {
 212                 $this->error = $status;
 213                 return false;
 214         }
 215 }