includes/actions/RawAction.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 HistoryAction and SpecialExport
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License along
  21  * with this program; if not, write to the Free Software Foundation, Inc.,
  22  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  23  * http://www.gnu.org/copyleft/gpl.html
  24  *
  25  * @author Gabriel Wicke <wicke@wikidev.net>
  26  * @file
  27  */
  28
  29 /**
  30  * A simple method to retrieve the plain source of an article,
  31  * using "action=raw" in the GET request string.
  32  *
  33  * @ingroup Actions
  34  */
  35 class RawAction extends FormlessAction {
  36         public function getName() {
  37                 return 'raw';
  38         }
  39
  40         public function requiresWrite() {
  41                 return false;
  42         }
  43
  44         public function requiresUnblock() {
  45                 return false;
  46         }
  47
  48         function onView() {
  49                 $this->getOutput()->disable();
  50                 $request = $this->getRequest();
  51                 $response = $request->response();
  52                 $config = $this->context->getConfig();
  53
  54                 if ( !$request->checkUrlExtension() ) {
  55                         return;
  56                 }
  57
  58                 if ( $this->getOutput()->checkLastModified( $this->page->getTouched() ) ) {
  59                         return; // Client cache fresh and headers sent, nothing more to do.
  60                 }
  61
  62                 $contentType = $this->getContentType();
  63
  64                 $maxage = $request->getInt( 'maxage', $config->get( 'SquidMaxage' ) );
  65                 $smaxage = $request->getIntOrNull( 'smaxage' );
  66                 if ( $smaxage === null ) {
  67                         if (
  68                                 $contentType == 'text/css' ||
  69                                 $contentType == 'application/json' ||
  70                                 $contentType == 'text/javascript'
  71                         ) {
  72                                 // CSS/JSON/JS raw content has its own CDN max age configuration.
  73                                 // Note: Title::getCdnUrls() includes action=raw for css/json/js
  74                                 // pages, so if using the canonical url, this will get HTCP purges.
  75                                 $smaxage = intval( $config->get( 'ForcedRawSMaxage' ) );
  76                         } else {
  77                                 // No CDN cache for anything else
  78                                 $smaxage = 0;
  79                         }
  80                 }
  81
  82                 // Set standard Vary headers so cache varies on cookies and such (T125283)
  83                 $response->header( $this->getOutput()->getVaryHeader() );
  84                 if ( $config->get( 'UseKeyHeader' ) ) {
  85                         $response->header( $this->getOutput()->getKeyHeader() );
  86                 }
  87
  88                 $response->header( 'Content-type: ' . $contentType . '; charset=UTF-8' );
  89                 // Output may contain user-specific data;
  90                 // vary generated content for open sessions on private wikis
  91                 $privateCache = !User::isEveryoneAllowed( 'read' ) &&
  92                         ( $smaxage == 0 || MediaWiki\Session\SessionManager::getGlobalSession()->isPersistent() );
  93                 // Don't accidentally cache cookies if user is logged in (T55032)
  94                 $privateCache = $privateCache || $this->getUser()->isLoggedIn();
  95                 $mode = $privateCache ? 'private' : 'public';
  96                 $response->header(
  97                         'Cache-Control: ' . $mode . ', s-maxage=' . $smaxage . ', max-age=' . $maxage
  98                 );
  99
 100                 $text = $this->getRawText();
 101
 102                 // Don't return a 404 response for CSS or JavaScript;
 103                 // 404s aren't generally cached and it would create
 104                 // extra hits when user CSS/JS are on and the user doesn't
 105                 // have the pages.
 106                 if ( $text === false && $contentType == 'text/x-wiki' ) {
 107                         $response->statusHeader( 404 );
 108                 }
 109
 110                 // Avoid PHP 7.1 warning of passing $this by reference
 111                 $rawAction = $this;
 112                 if ( !Hooks::run( 'RawPageViewBeforeOutput', [ &$rawAction, &$text ] ) ) {
 113                         wfDebug( __METHOD__ . ": RawPageViewBeforeOutput hook broke raw page output.\n" );
 114                 }
 115
 116                 echo $text;
 117         }
 118
 119         /**
 120          * Get the text that should be returned, or false if the page or revision
 121          * was not found.
 122          *
 123          * @return string|bool
 124          */
 125         public function getRawText() {
 126                 global $wgParser;
 127
 128                 $text = false;
 129                 $title = $this->getTitle();
 130                 $request = $this->getRequest();
 131
 132                 // If it's a MediaWiki message we can just hit the message cache
 133                 if ( $request->getBool( 'usemsgcache' ) && $title->getNamespace() == NS_MEDIAWIKI ) {
 134                         // The first "true" is to use the database, the second is to use
 135                         // the content langue and the last one is to specify the message
 136                         // key already contains the language in it ("/de", etc.).
 137                         $text = MessageCache::singleton()->get( $title->getDBkey(), true, true, true );
 138                         // If the message doesn't exist, return a blank
 139                         if ( $text === false ) {
 140                                 $text = '';
 141                         }
 142                 } else {
 143                         // Get it from the DB
 144                         $rev = Revision::newFromTitle( $title, $this->getOldId() );
 145                         if ( $rev ) {
 146                                 $lastmod = wfTimestamp( TS_RFC2822, $rev->getTimestamp() );
 147                                 $request->response()->header( "Last-modified: $lastmod" );
 148
 149                                 // Public-only due to cache headers
 150                                 $content = $rev->getContent();
 151
 152                                 if ( $content === null ) {
 153                                         // revision not found (or suppressed)
 154                                         $text = false;
 155                                 } elseif ( !$content instanceof TextContent ) {
 156                                         // non-text content
 157                                         wfHttpError( 415, "Unsupported Media Type", "The requested page uses the content model `"
 158                                                 . $content->getModel() . "` which is not supported via this interface." );
 159                                         die();
 160                                 } else {
 161                                         // want a section?
 162                                         $section = $request->getIntOrNull( 'section' );
 163                                         if ( $section !== null ) {
 164                                                 $content = $content->getSection( $section );
 165                                         }
 166
 167                                         if ( $content === null || $content === false ) {
 168                                                 // section not found (or section not supported, e.g. for JS, JSON, and CSS)
 169                                                 $text = false;
 170                                         } else {
 171                                                 $text = $content->getNativeData();
 172                                         }
 173                                 }
 174                         }
 175                 }
 176
 177                 if ( $text !== false && $text !== '' && $request->getRawVal( 'templates' ) === 'expand' ) {
 178                         $text = $wgParser->preprocess(
 179                                 $text,
 180                                 $title,
 181                                 ParserOptions::newFromContext( $this->getContext() )
 182                         );
 183                 }
 184
 185                 return $text;
 186         }
 187
 188         /**
 189          * Get the ID of the revision that should used to get the text.
 190          *
 191          * @return int
 192          */
 193         public function getOldId() {
 194                 $oldid = $this->getRequest()->getInt( 'oldid' );
 195                 switch ( $this->getRequest()->getText( 'direction' ) ) {
 196                         case 'next':
 197                                 # output next revision, or nothing if there isn't one
 198                                 $nextid = 0;
 199                                 if ( $oldid ) {
 200                                         $nextid = $this->getTitle()->getNextRevisionID( $oldid );
 201                                 }
 202                                 $oldid = $nextid ?: -1;
 203                                 break;
 204                         case 'prev':
 205                                 # output previous revision, or nothing if there isn't one
 206                                 if ( !$oldid ) {
 207                                         # get the current revision so we can get the penultimate one
 208                                         $oldid = $this->page->getLatest();
 209                                 }
 210                                 $previd = $this->getTitle()->getPreviousRevisionID( $oldid );
 211                                 $oldid = $previd ?: -1;
 212                                 break;
 213                         case 'cur':
 214                                 $oldid = 0;
 215                                 break;
 216                 }
 217
 218                 return $oldid;
 219         }
 220
 221         /**
 222          * Get the content type to use for the response
 223          *
 224          * @return string
 225          */
 226         public function getContentType() {
 227                 // Use getRawVal instead of getVal because we only
 228                 // need to match against known strings, there is no
 229                 // storing of localised content or other user input.
 230                 $ctype = $this->getRequest()->getRawVal( 'ctype' );
 231
 232                 if ( $ctype == '' ) {
 233                         // Legacy compatibilty
 234                         $gen = $this->getRequest()->getRawVal( 'gen' );
 235                         if ( $gen == 'js' ) {
 236                                 $ctype = 'text/javascript';
 237                         } elseif ( $gen == 'css' ) {
 238                                 $ctype = 'text/css';
 239                         }
 240                 }
 241
 242                 $allowedCTypes = [
 243                         'text/x-wiki',
 244                         'text/javascript',
 245                         'text/css',
 246                         // FIXME: Should we still allow Zope editing? External editing feature was dropped
 247                         'application/x-zope-edit',
 248                         'application/json'
 249                 ];
 250                 if ( $ctype == '' || !in_array( $ctype, $allowedCTypes ) ) {
 251                         $ctype = 'text/x-wiki';
 252                 }
 253
 254                 return $ctype;
 255         }
 256 }