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.
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.
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
21 class PoolWorkArticleView
extends PoolCounterWork
{
31 /** @var ParserOptions */
32 private $parserOptions;
34 /** @var Content|null */
35 private $content = null;
37 /** @var ParserOutput|bool */
38 private $parserOutput = false;
41 private $isDirty = false;
43 /** @var Status|bool */
44 private $error = false;
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.
52 * @param Content|string $content Content to parse or null to load it; may
53 * also be given as a wikitext string, for BC.
55 public function __construct( Page
$page, ParserOptions
$parserOptions,
56 $revid, $useParserCache, $content = null
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 );
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 parent
::__construct( 'ArticleView', $this->cacheKey
. ':revid:' . $revid );
74 * Get the ParserOutput from this object, or false in case of failure
76 * @return ParserOutput
78 public function getParserOutput() {
79 return $this->parserOutput
;
83 * Get whether the ParserOutput is a dirty one (i.e. expired)
87 public function getIsDirty() {
88 return $this->isDirty
;
92 * Get a Status object in case of error or false otherwise
96 public function getError() {
103 public function doWork() {
104 global $wgUseFileCache;
106 // @todo several of the methods called on $this->page are not declared in Page, but present
107 // in WikiPage and delegated by Article.
109 $isCurrent = $this->revid
=== $this->page
->getLatest();
111 if ( $this->content
!== null ) {
112 $content = $this->content
;
113 } elseif ( $isCurrent ) {
114 // XXX: why use RAW audience here, and PUBLIC (default) below?
115 $content = $this->page
->getContent( Revision
::RAW
);
117 $rev = Revision
::newFromTitle( $this->page
->getTitle(), $this->revid
);
119 if ( $rev === null ) {
122 // XXX: why use PUBLIC audience here (default), and RAW above?
123 $content = $rev->getContent();
127 if ( $content === null ) {
131 // Reduce effects of race conditions for slow parses (bug 46014)
132 $cacheTime = wfTimestampNow();
134 $time = - microtime( true );
135 $this->parserOutput
= $content->getParserOutput(
136 $this->page
->getTitle(),
140 $time +
= microtime( true );
144 wfDebugLog( 'slow-parse', sprintf( "%-5.2f %s", $time,
145 $this->page
->getTitle()->getPrefixedDBkey() ) );
148 if ( $this->cacheable
&& $this->parserOutput
->isCacheable() && $isCurrent ) {
149 ParserCache
::singleton()->save(
150 $this->parserOutput
, $this->page
, $this->parserOptions
, $cacheTime, $this->revid
);
153 // Make sure file cache is not used on uncacheable content.
154 // Output that has magic words in it can still use the parser cache
155 // (if enabled), though it will generally expire sooner.
156 if ( !$this->parserOutput
->isCacheable() ||
$this->parserOutput
->containsOldMagic() ) {
157 $wgUseFileCache = false;
161 $this->page
->doCascadeProtectionUpdates( $this->parserOutput
);
170 public function getCachedWork() {
171 $this->parserOutput
= ParserCache
::singleton()->get( $this->page
, $this->parserOptions
);
173 if ( $this->parserOutput
=== false ) {
174 wfDebug( __METHOD__
. ": parser cache miss\n" );
177 wfDebug( __METHOD__
. ": parser cache hit\n" );
185 public function fallback() {
186 $this->parserOutput
= ParserCache
::singleton()->getDirty( $this->page
, $this->parserOptions
);
188 if ( $this->parserOutput
=== false ) {
189 wfDebugLog( 'dirty', 'dirty missing' );
190 wfDebug( __METHOD__
. ": no dirty cache\n" );
193 wfDebug( __METHOD__
. ": sending dirty output\n" );
194 wfDebugLog( 'dirty', "dirty output {$this->cacheKey}" );
195 $this->isDirty
= true;
201 * @param Status $status
204 public function error( $status ) {
205 $this->error
= $status;