67d31172f734707eb8511527d44eaa22d2dc0588
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.
20 class RawAction
extends FormlessAction
{
23 public function getName() {
27 public function getRestriction() {
31 public function requiresWrite() {
35 public function requiresUnblock() {
40 global $wgGroupPermissions, $wgSquidMaxage, $wgForcedRawSMaxage, $wgJsMimeType;
42 $this->getOutput()->disable();
43 $request = $this->getRequest();
45 if ( !$request->checkUrlExtension() ) {
49 # special case for 'generated' raw things: user css/js
50 # This is deprecated and will only return empty content
51 $gen = $request->getVal( 'gen' );
52 $smaxage = $request->getIntOrNull( 'smaxage' );
54 if ( $gen == 'css' ||
$gen == 'js' ) {
56 if ( $smaxage === null ) {
57 $smaxage = $wgSquidMaxage;
63 $contentType = $this->getContentType();
65 # Force caching for CSS and JS raw content, default: 5 minutes
66 if ( $smaxage === null ) {
67 if ( $contentType == 'text/css' ||
$contentType == $wgJsMimeType ) {
68 $smaxage = intval( $wgForcedRawSMaxage );
74 $maxage = $request->getInt( 'maxage', $wgSquidMaxage );
76 $response = $request->response();
78 $response->header( 'Content-type: ' . $contentType . '; charset=UTF-8' );
79 # Output may contain user-specific data;
80 # vary generated content for open sessions on private wikis
81 $privateCache = !$wgGroupPermissions['*']['read']
82 && ( $smaxage == 0 ||
session_id() != '' );
83 # allow the client to cache this for 24 hours
84 $mode = $privateCache ?
'private' : 'public';
85 $response->header( 'Cache-Control: ' . $mode . ', s-maxage=' . $smaxage . ', max-age=' . $maxage );
87 $text = $this->getRawText();
89 if ( $text === false && $contentType == 'text/x-wiki' ) {
90 # Don't return a 404 response for CSS or JavaScript;
91 # 404s aren't generally cached and it would create
92 # extra hits when user CSS/JS are on and the user doesn't
94 $response->header( 'HTTP/1.x 404 Not Found' );
97 if ( !wfRunHooks( 'RawPageViewBeforeOutput', array( &$this, &$text ) ) ) {
98 wfDebug( __METHOD__
. ": RawPageViewBeforeOutput hook broke raw page output.\n" );
105 * Get the text that should be returned, or false if the page or revision
108 * @return String|Bool
110 public function getRawText() {
119 $title = $this->getTitle();
120 $request = $this->getRequest();
122 // If it's a MediaWiki message we can just hit the message cache
123 if ( $request->getBool( 'usemsgcache' ) && $title->getNamespace() == NS_MEDIAWIKI
) {
124 $msg = wfMessage( $title->getDBkey() )->inContentLanguage();
125 # If the message doesn't exist, return a blank
126 $text = !$msg->exists() ?
'' : $msg->plain();
128 // Get it from the DB
129 $rev = Revision
::newFromTitle( $title, $this->getOldId() );
131 $lastmod = wfTimestamp( TS_RFC2822
, $rev->getTimestamp() );
132 $request->response()->header( "Last-modified: $lastmod" );
134 $text = $rev->getText( Revision
::FOR_THIS_USER
, $this->getUser() );
135 $section = $request->getIntOrNull( 'section' );
136 if ( $section !== null ) {
137 $text = $wgParser->getSection( $text, $section );
142 if ( $text !== false && $text !== '' && $request->getVal( 'templates' ) === 'expand' ) {
143 $text = $wgParser->preprocess( $text, $title, ParserOptions
::newFromContext( $this->getContext() ) );
150 * Get the ID of the revision that should used to get the text.
154 public function getOldId() {
155 $oldid = $this->getRequest()->getInt( 'oldid' );
156 switch ( $this->getRequest()->getText( 'direction' ) ) {
158 # output next revision, or nothing if there isn't one
160 $oldid = $this->getTitle()->getNextRevisionId( $oldid );
162 $oldid = $oldid ?
$oldid : -1;
165 # output previous revision, or nothing if there isn't one
167 # get the current revision so we can get the penultimate one
168 $oldid = $this->getTitle()->getLatestRevID();
170 $prev = $this->getTitle()->getPreviousRevisionId( $oldid );
171 $oldid = $prev ?
$prev : -1 ;
181 * Get the content type to use for the response
185 public function getContentType() {
186 global $wgJsMimeType;
188 $ctype = $this->getRequest()->getVal( 'ctype' );
190 if ( $ctype == '' ) {
191 $gen = $this->getRequest()->getVal( 'gen' );
192 if ( $gen == 'js' ) {
193 $ctype = $wgJsMimeType;
194 } elseif ( $gen == 'css' ) {
199 $allowedCTypes = array( 'text/x-wiki', $wgJsMimeType, 'text/css', 'application/x-zope-edit' );
200 if ( $ctype == '' ||
!in_array( $ctype, $allowedCTypes ) ) {
201 $ctype = 'text/x-wiki';
209 * Backward compatibility for extensions
211 * @deprecated in 1.19
213 class RawPage
extends RawAction
{
216 function __construct( Page
$page, $request = false ) {
217 parent
::__construct( $page );
219 if ( $request !== false ) {
220 $context = new DerivativeContext( $this->getContext() );
221 $context->setRequest( $request );
222 $this->context
= $context;
226 public function view() {
230 public function getOldId() {
231 # Some extensions like to set $mOldId
232 if ( $this->mOldId
!== null ) {
233 return $this->mOldId
;
235 return parent
::getOldId();