CreationHandler.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\Rest\Handler;
 
use MediaWiki\Request\WebResponse;
use MediaWiki\Rest\LocalizedHttpException;
use MediaWiki\Rest\Response;
use Wikimedia\Message\MessageValue;
use Wikimedia\ParamValidator\ParamValidator;
 
class CreationHandler extends EditHandler {
 
    protected function getTitleParameter() {
        $body = $this->getValidatedBody();
        '@phan-var array $body';
        return $body['title'];
    }
 
    public function getParamSettings() {
        return [
            'source' => [
                self::PARAM_SOURCE => 'body',
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => true,
                self::PARAM_DESCRIPTION => 'The intended content of the page',
            ],
            'title' => [
                self::PARAM_SOURCE => 'body',
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => true,
                self::PARAM_DESCRIPTION => 'The title of the page to create',
            ],
            'comment' => [
                self::PARAM_SOURCE => 'body',
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => true,
                self::PARAM_DESCRIPTION => 'A comment descripting the reason for creating the page',
            ],
            'content_model' => [
                self::PARAM_SOURCE => 'body',
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => false,
                self::PARAM_DESCRIPTION => 'The content model to use to interpret the source',
            ],
        ]
            + $this->getTokenParamDefinition()
            + parent::getParamSettings();
    }
 
    protected function getActionModuleParameters() {
        $body = $this->getValidatedBody();
        '@phan-var array $body';
 
        $title = $this->getTitleParameter();
 
        $contentmodel = $body['content_model'] ?: null;
 
        if ( $contentmodel !== null && !$this->contentHandlerFactory->isDefinedModel( $contentmodel ) ) {
            throw new LocalizedHttpException(
                new MessageValue( 'rest-bad-content-model', [ $body['content_model'] ] ), 400
            );
        }
 
        // Use a known good CSRF token if a token is not needed because we are
        // using a method of authentication that protects against CSRF, like OAuth.
        $token = $this->needsToken() ? $this->getToken() : $this->getUser()->getEditToken();
 
        $params = [
            'action' => 'edit',
            'title' => $title,
            'text' => $body['source'],
            'summary' => $body['comment'],
            'token' => $token,
            'createonly' => true,
        ];
 
        if ( $contentmodel !== null ) {
            $params['contentmodel'] = $contentmodel;
        }
 
        return $params;
    }
 
    protected function mapActionModuleResponse(
        WebResponse $actionModuleResponse,
        array $actionModuleResult,
        Response $response
    ) {
        parent::mapActionModuleResponse(
            $actionModuleResponse,
            $actionModuleResult,
            $response
        );
 
        $title = $this->urlEncodeTitle( $actionModuleResult['edit']['title'] );
 
        $url = $this->getRouter()->getRouteUrl( '/v1/page/' . $title );
        $response->setHeader( 'Location', $url );
    }
 
}