| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/includes/api/ |
Upload File : |
<?php
/**
* Copyright © 2009 Roan Kattouw <roan.kattouw@gmail.com>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\Api;
/**
* Formatter that spits out anything you like with any desired MIME type
* @ingroup API
*/
class ApiFormatRaw extends ApiFormatBase {
/** @var ApiFormatBase|null */
private $errorFallback;
/** @var bool */
private $mFailWithHTTPError = false;
/**
* @param ApiMain $main
* @param ApiFormatBase|null $errorFallback Object to fall back on for errors
*/
public function __construct( ApiMain $main, ?ApiFormatBase $errorFallback = null ) {
parent::__construct( $main, 'raw' );
$this->errorFallback = $errorFallback ?:
$main->createPrinterByName( $main->getParameter( 'format' ) );
}
public function getMimeType() {
$data = $this->getResult()->getResultData();
if ( isset( $data['error'] ) || isset( $data['errors'] ) ) {
return $this->errorFallback->getMimeType();
}
if ( !isset( $data['mime'] ) ) {
ApiBase::dieDebug( __METHOD__, 'No MIME type set for raw formatter' );
}
return $data['mime'];
}
public function getFilename() {
$data = $this->getResult()->getResultData();
if ( isset( $data['error'] ) ) {
return $this->errorFallback->getFilename();
} elseif ( !isset( $data['filename'] ) || $this->getIsWrappedHtml() || $this->getIsHtml() ) {
return parent::getFilename();
} else {
return $data['filename'];
}
}
public function initPrinter( $unused = false ) {
$data = $this->getResult()->getResultData();
if ( isset( $data['error'] ) || isset( $data['errors'] ) ) {
$this->errorFallback->initPrinter( $unused );
if ( $this->mFailWithHTTPError ) {
$this->getMain()->getRequest()->response()->statusHeader( 400 );
}
} else {
parent::initPrinter( $unused );
}
}
public function closePrinter() {
$data = $this->getResult()->getResultData();
if ( isset( $data['error'] ) || isset( $data['errors'] ) ) {
$this->errorFallback->closePrinter();
} else {
parent::closePrinter();
}
}
public function execute() {
$data = $this->getResult()->getResultData();
if ( isset( $data['error'] ) || isset( $data['errors'] ) ) {
$this->errorFallback->execute();
return;
}
if ( !isset( $data['text'] ) ) {
ApiBase::dieDebug( __METHOD__, 'No text given for raw formatter' );
}
$this->printText( $data['text'] );
}
/**
* Output HTTP error code 400 when if an error is encountered
*
* The purpose is for output formats where the user-agent will
* not be able to interpret the validity of the content in any
* other way. For example subtitle files read by browser video players.
*
* @param bool $fail
*/
public function setFailWithHTTPError( $fail ) {
$this->mFailWithHTTPError = $fail;
}
}
/** @deprecated class alias since 1.43 */
class_alias( ApiFormatRaw::class, 'ApiFormatRaw' );