includes/RawPage.php

   1 <?php
   2 /**
   3  * Raw page text accessor
   4  *
   5  * Copyright © 2004 Gabriel Wicke <wicke@wikidev.net>
   6  * http://wikidev.net/
   7  *
   8  * Based on HistoryPage and SpecialExport
   9  *
  10  * License: GPL (http://www.gnu.org/copyleft/gpl.html)
  11  *
  12  * @author Gabriel Wicke <wicke@wikidev.net>
  13  * @file
  14  */
  15
  16 /**
  17  * A simple method to retrieve the plain source of an article,
  18  * using "action=raw" in the GET request string.
  19  */
  20 class RawPage {
  21         var $mArticle, $mTitle, $mRequest;
  22         var $mOldId, $mGen, $mCharset, $mSection;
  23         var $mSmaxage, $mMaxage;
  24         var $mContentType, $mExpandTemplates;
  25
  26         function __construct( Article $article, $request = false ) {
  27                 global $wgRequest, $wgInputEncoding, $wgSquidMaxage, $wgJsMimeType, $wgGroupPermissions;
  28
  29                 $allowedCTypes = array( 'text/x-wiki', $wgJsMimeType, 'text/css', 'application/x-zope-edit' );
  30                 $this->mArticle = $article;
  31                 $this->mTitle = $article->mTitle;
  32
  33                 if( $request === false ) {
  34                         $this->mRequest = $wgRequest;
  35                 } else {
  36                         $this->mRequest = $request;
  37                 }
  38
  39                 $ctype = $this->mRequest->getVal( 'ctype' );
  40                 $smaxage = $this->mRequest->getIntOrNull( 'smaxage' );
  41                 $maxage = $this->mRequest->getInt( 'maxage', $wgSquidMaxage );
  42
  43                 $this->mExpandTemplates = $this->mRequest->getVal( 'templates' ) === 'expand';
  44                 $this->mUseMessageCache = $this->mRequest->getBool( 'usemsgcache' );
  45
  46                 $this->mSection = $this->mRequest->getIntOrNull( 'section' );
  47
  48                 $oldid = $this->mRequest->getInt( 'oldid' );
  49
  50                 switch( $wgRequest->getText( 'direction' ) ) {
  51                         case 'next':
  52                                 # output next revision, or nothing if there isn't one
  53                                 if( $oldid ) {
  54                                         $oldid = $this->mTitle->getNextRevisionId( $oldid );
  55                                 }
  56                                 $oldid = $oldid ? $oldid : -1;
  57                                 break;
  58                         case 'prev':
  59                                 # output previous revision, or nothing if there isn't one
  60                                 if( !$oldid ) {
  61                                         # get the current revision so we can get the penultimate one
  62                                         $this->mArticle->getTouched();
  63                                         $oldid = $this->mArticle->mLatest;
  64                                 }
  65                                 $prev = $this->mTitle->getPreviousRevisionId( $oldid );
  66                                 $oldid = $prev ? $prev : -1 ;
  67                                 break;
  68                         case 'cur':
  69                                 $oldid = 0;
  70                                 break;
  71                 }
  72                 $this->mOldId = $oldid;
  73
  74                 # special case for 'generated' raw things: user css/js
  75                 $gen = $this->mRequest->getVal( 'gen' );
  76
  77                 if( $gen == 'css' ) {
  78                         $this->mGen = $gen;
  79                         if( is_null( $smaxage ) ) {
  80                                 $smaxage = $wgSquidMaxage;
  81                         }
  82                         if( $ctype == '' ) {
  83                                 $ctype = 'text/css';
  84                         }
  85                 } elseif( $gen == 'js' ) {
  86                         $this->mGen = $gen;
  87                         if( is_null( $smaxage ) ) $smaxage = $wgSquidMaxage;
  88                         if($ctype == '') $ctype = $wgJsMimeType;
  89                 } else {
  90                         $this->mGen = false;
  91                 }
  92                 $this->mCharset = $wgInputEncoding;
  93
  94                 # Force caching for CSS and JS raw content, default: 5 minutes
  95                 if( is_null( $smaxage ) && ( $ctype == 'text/css' || $ctype == $wgJsMimeType ) ) {
  96                         global $wgForcedRawSMaxage;
  97                         $this->mSmaxage = intval( $wgForcedRawSMaxage );
  98                 } else {
  99                         $this->mSmaxage = intval( $smaxage );
 100                 }
 101                 $this->mMaxage = $maxage;
 102
 103                 # Output may contain user-specific data;
 104                 # vary generated content for open sessions and private wikis
 105                 if( $this->mGen || !$wgGroupPermissions['*']['read'] ) {
 106                         $this->mPrivateCache = $this->mSmaxage == 0 || session_id() != '';
 107                 } else {
 108                         $this->mPrivateCache = false;
 109                 }
 110
 111                 if( $ctype == '' || !in_array( $ctype, $allowedCTypes ) ) {
 112                         $this->mContentType = 'text/x-wiki';
 113                 } else {
 114                         $this->mContentType = $ctype;
 115                 }
 116         }
 117
 118         function view() {
 119                 global $wgOut, $wgRequest;
 120
 121                 if( $wgRequest->isPathInfoBad() ) {
 122                         # Internet Explorer will ignore the Content-Type header if it
 123                         # thinks it sees a file extension it recognizes. Make sure that
 124                         # all raw requests are done through the script node, which will
 125                         # have eg '.php' and should remain safe.
 126                         #
 127                         # We used to redirect to a canonical-form URL as a general
 128                         # backwards-compatibility / good-citizen nice thing. However
 129                         # a lot of servers are set up in buggy ways, resulting in
 130                         # redirect loops which hang the browser until the CSS load
 131                         # times out.
 132                         #
 133                         # Just return a 403 Forbidden and get it over with.
 134                         wfHttpError( 403, 'Forbidden',
 135                                 'Invalid file extension found in PATH_INFO. ' .
 136                                 'Raw pages must be accessed through the primary script entry point.' );
 137                         return;
 138                 }
 139
 140                 header( 'Content-type: ' . $this->mContentType . '; charset=' . $this->mCharset );
 141                 # allow the client to cache this for 24 hours
 142                 $mode = $this->mPrivateCache ? 'private' : 'public';
 143                 header( 'Cache-Control: ' . $mode . ', s-maxage=' . $this->mSmaxage . ', max-age=' . $this->mMaxage );
 144
 145                 global $wgUseFileCache;
 146                 if( $wgUseFileCache && HTMLFileCache::useFileCache() ) {
 147                         $cache = new HTMLFileCache( $this->mTitle, 'raw' );
 148                         if( $cache->isFileCacheGood( /* Assume up to date */ ) ) {
 149                                 $cache->loadFromFileCache();
 150                                 $wgOut->disable();
 151                                 return;
 152                         } else {
 153                                 ob_start( array( &$cache, 'saveToFileCache' ) );
 154                         }
 155                 }
 156
 157                 $text = $this->getRawText();
 158
 159                 if( !wfRunHooks( 'RawPageViewBeforeOutput', array( &$this, &$text ) ) ) {
 160                         wfDebug( __METHOD__ . ": RawPageViewBeforeOutput hook broke raw page output.\n" );
 161                 }
 162
 163                 echo $text;
 164                 $wgOut->disable();
 165         }
 166
 167         function getRawText() {
 168                 global $wgUser, $wgOut;
 169                 if( $this->mGen ) {
 170                         $sk = $wgUser->getSkin();
 171                         if( !StubObject::isRealObject( $wgOut ) ) {
 172                                 $wgOut->_unstub( 2 );
 173                         }
 174                         $sk->initPage( $wgOut );
 175                         if( $this->mGen == 'css' ) {
 176                                 return $sk->generateUserStylesheet();
 177                         } else if( $this->mGen == 'js' ) {
 178                                 return $sk->generateUserJs();
 179                         }
 180                 } else {
 181                         return $this->getArticleText();
 182                 }
 183         }
 184
 185         function getArticleText() {
 186                 $found = false;
 187                 $text = '';
 188                 if( $this->mTitle ) {
 189                         // If it's a MediaWiki message we can just hit the message cache
 190                         if( $this->mUseMessageCache && $this->mTitle->getNamespace() == NS_MEDIAWIKI ) {
 191                                 $key = $this->mTitle->getDBkey();
 192                                 $text = wfMsgForContentNoTrans( $key );
 193                                 # If the message doesn't exist, return a blank
 194                                 if( wfEmptyMsg( $key, $text ) ) {
 195                                         $text = '';
 196                                 }
 197                                 $found = true;
 198                         } else {
 199                                 // Get it from the DB
 200                                 $rev = Revision::newFromTitle( $this->mTitle, $this->mOldId );
 201                                 if( $rev ) {
 202                                         $lastmod = wfTimestamp( TS_RFC2822, $rev->getTimestamp() );
 203                                         header( "Last-modified: $lastmod" );
 204
 205                                         if( !is_null( $this->mSection ) ) {
 206                                                 global $wgParser;
 207                                                 $text = $wgParser->getSection( $rev->getText(), $this->mSection );
 208                                         } else {
 209                                                 $text = $rev->getText();
 210                                         }
 211                                         $found = true;
 212                                 }
 213                         }
 214                 }
 215
 216                 # Bad title or page does not exist
 217                 if( !$found && $this->mContentType == 'text/x-wiki' ) {
 218                         # Don't return a 404 response for CSS or JavaScript;
 219                         # 404s aren't generally cached and it would create
 220                         # extra hits when user CSS/JS are on and the user doesn't
 221                         # have the pages.
 222                         header( 'HTTP/1.0 404 Not Found' );
 223                 }
 224
 225                 // Special-case for empty CSS/JS
 226                 //
 227                 // Internet Explorer for Mac handles empty files badly;
 228                 // particularly so when keep-alive is active. It can lead
 229                 // to long timeouts as it seems to sit there waiting for
 230                 // more data that never comes.
 231                 //
 232                 // Give it a comment...
 233                 if( strlen( $text ) == 0 &&
 234                         ( $this->mContentType == 'text/css' ||
 235                                 $this->mContentType == 'text/javascript' ) ) {
 236                         return '/* Empty */';
 237                 }
 238
 239                 return $this->parseArticleText( $text );
 240         }
 241
 242         function parseArticleText( $text ) {
 243                 if( $text === '' ) {
 244                         return '';
 245                 } else {
 246                         if( $this->mExpandTemplates ) {
 247                                 global $wgParser;
 248                                 return $wgParser->preprocess( $text, $this->mTitle, new ParserOptions() );
 249                         } else {
 250                                 return $text;
 251                         }
 252                 }
 253         }
 254 }