3 * Raw page text accessor
5 * Copyright © 2004 Gabriel Wicke <wicke@wikidev.net>
8 * Based on HistoryPage and SpecialExport
10 * License: GPL (http://www.gnu.org/copyleft/gpl.html)
12 * @author Gabriel Wicke <wicke@wikidev.net>
17 * A simple method to retrieve the plain source of an article,
18 * using "action=raw" in the GET request string.
21 var $mArticle, $mTitle, $mRequest;
22 var $mOldId, $mGen, $mCharset, $mSection;
23 var $mSmaxage, $mMaxage;
24 var $mContentType, $mExpandTemplates;
26 function __construct( Article
$article, $request = false ) {
27 global $wgRequest, $wgInputEncoding, $wgSquidMaxage, $wgJsMimeType, $wgGroupPermissions;
29 $allowedCTypes = array('text/x-wiki', $wgJsMimeType, 'text/css', 'application/x-zope-edit');
30 $this->mArticle
= $article;
31 $this->mTitle
= $article->mTitle
;
33 if( $request === false ) {
34 $this->mRequest
= $wgRequest;
36 $this->mRequest
= $request;
39 $ctype = $this->mRequest
->getVal( 'ctype' );
40 $smaxage = $this->mRequest
->getIntOrNull( 'smaxage' );
41 $maxage = $this->mRequest
->getInt( 'maxage', $wgSquidMaxage );
43 $this->mExpandTemplates
= $this->mRequest
->getVal( 'templates' ) === 'expand';
44 $this->mUseMessageCache
= $this->mRequest
->getBool( 'usemsgcache' );
46 $this->mSection
= $this->mRequest
->getIntOrNull( 'section' );
48 $oldid = $this->mRequest
->getInt( 'oldid' );
50 switch( $wgRequest->getText( 'direction' ) ) {
52 # output next revision, or nothing if there isn't one
54 $oldid = $this->mTitle
->getNextRevisionId( $oldid );
56 $oldid = $oldid ?
$oldid : -1;
59 # output previous revision, or nothing if there isn't one
61 # get the current revision so we can get the penultimate one
62 $this->mArticle
->getTouched();
63 $oldid = $this->mArticle
->mLatest
;
65 $prev = $this->mTitle
->getPreviousRevisionId( $oldid );
66 $oldid = $prev ?
$prev : -1 ;
72 $this->mOldId
= $oldid;
74 # special case for 'generated' raw things: user css/js
75 $gen = $this->mRequest
->getVal( 'gen' );
79 if( is_null( $smaxage ) ) $smaxage = $wgSquidMaxage;
80 if($ctype == '') $ctype = 'text/css';
81 } elseif( $gen == 'js' ) {
83 if( is_null( $smaxage ) ) $smaxage = $wgSquidMaxage;
84 if($ctype == '') $ctype = $wgJsMimeType;
88 $this->mCharset
= $wgInputEncoding;
90 # Force caching for CSS and JS raw content, default: 5 minutes
91 if( is_null($smaxage) and ($ctype=='text/css' or $ctype==$wgJsMimeType) ) {
92 global $wgForcedRawSMaxage;
93 $this->mSmaxage
= intval($wgForcedRawSMaxage);
95 $this->mSmaxage
= intval( $smaxage );
97 $this->mMaxage
= $maxage;
99 # Output may contain user-specific data;
100 # vary generated content for open sessions and private wikis
101 if( $this->mGen
or !$wgGroupPermissions['*']['read'] ) {
102 $this->mPrivateCache
= $this->mSmaxage
== 0 ||
session_id() != '';
104 $this->mPrivateCache
= false;
107 if( $ctype == '' or ! in_array( $ctype, $allowedCTypes ) ) {
108 $this->mContentType
= 'text/x-wiki';
110 $this->mContentType
= $ctype;
115 global $wgOut, $wgRequest;
117 if( $wgRequest->isPathInfoBad() ) {
118 # Internet Explorer will ignore the Content-Type header if it
119 # thinks it sees a file extension it recognizes. Make sure that
120 # all raw requests are done through the script node, which will
121 # have eg '.php' and should remain safe.
123 # We used to redirect to a canonical-form URL as a general
124 # backwards-compatibility / good-citizen nice thing. However
125 # a lot of servers are set up in buggy ways, resulting in
126 # redirect loops which hang the browser until the CSS load
129 # Just return a 403 Forbidden and get it over with.
130 wfHttpError( 403, 'Forbidden',
131 'Invalid file extension found in PATH_INFO. ' .
132 'Raw pages must be accessed through the primary script entry point.' );
136 header( "Content-type: ".$this->mContentType
.'; charset='.$this->mCharset
);
137 # allow the client to cache this for 24 hours
138 $mode = $this->mPrivateCache ?
'private' : 'public';
139 header( 'Cache-Control: '.$mode.', s-maxage='.$this->mSmaxage
.', max-age='.$this->mMaxage
);
141 global $wgUseFileCache;
142 if( $wgUseFileCache and HTMLFileCache
::useFileCache() ) {
143 $cache = new HTMLFileCache( $this->mTitle
, 'raw' );
144 if( $cache->isFileCacheGood( /* Assume up to date */ ) ) {
145 $cache->loadFromFileCache();
149 ob_start( array(&$cache, 'saveToFileCache' ) );
153 $text = $this->getRawText();
155 if( !wfRunHooks( 'RawPageViewBeforeOutput', array( &$this, &$text ) ) ) {
156 wfDebug( __METHOD__
. ": RawPageViewBeforeOutput hook broke raw page output.\n" );
163 function getRawText() {
164 global $wgUser, $wgOut;
166 $sk = $wgUser->getSkin();
167 if( !StubObject
::isRealObject( $wgOut ) )
168 $wgOut->_unstub( 2 );
169 $sk->initPage( $wgOut );
170 if( $this->mGen
== 'css' ) {
171 return $sk->generateUserStylesheet();
172 } else if( $this->mGen
== 'js' ) {
173 return $sk->generateUserJs();
176 return $this->getArticleText();
180 function getArticleText() {
183 if( $this->mTitle
) {
184 // If it's a MediaWiki message we can just hit the message cache
185 if( $this->mUseMessageCache
&& $this->mTitle
->getNamespace() == NS_MEDIAWIKI
) {
186 $key = $this->mTitle
->getDBkey();
187 $text = wfMsgForContentNoTrans( $key );
188 # If the message doesn't exist, return a blank
189 if( wfEmptyMsg( $key, $text ) )
193 // Get it from the DB
194 $rev = Revision
::newFromTitle( $this->mTitle
, $this->mOldId
);
196 $lastmod = wfTimestamp( TS_RFC2822
, $rev->getTimestamp() );
197 header( "Last-modified: $lastmod" );
199 if( !is_null($this->mSection
) ) {
201 $text = $wgParser->getSection ( $rev->getText(), $this->mSection
);
203 $text = $rev->getText();
209 # Bad title or page does not exist
210 if( !$found && $this->mContentType
== 'text/x-wiki' ) {
211 # Don't return a 404 response for CSS or JavaScript;
212 # 404s aren't generally cached and it would create
213 # extra hits when user CSS/JS are on and the user doesn't
215 header( "HTTP/1.0 404 Not Found" );
218 // Special-case for empty CSS/JS
220 // Internet Explorer for Mac handles empty files badly;
221 // particularly so when keep-alive is active. It can lead
222 // to long timeouts as it seems to sit there waiting for
223 // more data that never comes.
225 // Give it a comment...
226 if( strlen( $text ) == 0 &&
227 ($this->mContentType
== 'text/css' ||
228 $this->mContentType
== 'text/javascript' ) ) {
229 return "/* Empty */";
232 return $this->parseArticleText( $text );
235 function parseArticleText( $text ) {
239 if( $this->mExpandTemplates
) {
241 return $wgParser->preprocess( $text, $this->mTitle
, new ParserOptions() );