<?php
/**
- * API for MediaWiki 1.8+
+ *
*
* Created on Jan 4, 2008
*
- * Copyright © 2008 Yuri Astrakhan <Firstname><Lastname>@gmail.com,
+ * Copyright © 2008 Yuri Astrakhan "<Firstname><Lastname>@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
* @file
*/
-if ( !defined( 'MEDIAWIKI' ) ) {
- // Eclipse helper - will be ignored in production
- require_once( 'ApiBase.php' );
-}
+use MediaWiki\Session\BotPasswordSessionProvider;
/**
* API module to allow users to log out of the wiki. API equivalent of
*/
class ApiLogout extends ApiBase {
- public function __construct( $main, $action ) {
- parent::__construct( $main, $action );
- }
-
public function execute() {
- global $wgUser;
- $oldName = $wgUser->getName();
- $wgUser->logout();
+ $session = MediaWiki\Session\SessionManager::getGlobalSession();
+
+ // Handle bot password logout specially
+ if ( $session->getProvider() instanceof BotPasswordSessionProvider ) {
+ $session->unpersist();
+ return;
+ }
+
+ // Make sure it's possible to log out
+ if ( !$session->canSetUser() ) {
+ $this->dieWithError(
+ [
+ 'cannotlogoutnow-text',
+ $session->getProvider()->describe( $this->getErrorFormatter()->getLanguage() )
+ ],
+ 'cannotlogout'
+ );
+ }
+
+ $user = $this->getUser();
+ $oldName = $user->getName();
+ $user->logout();
// Give extensions to do something after user logout
$injected_html = '';
- wfRunHooks( 'UserLogoutComplete', array( &$wgUser, &$injected_html, $oldName ) );
+ Hooks::run( 'UserLogoutComplete', [ &$user, &$injected_html, $oldName ] );
}
- public function isReadMode() {
- return false;
+ public function mustBePosted() {
+ return true;
}
- public function getAllowedParams() {
- return array();
+ public function needsToken() {
+ return 'csrf';
}
- public function getParamDescription() {
- return array();
+ protected function getWebUITokenSalt( array $params ) {
+ return 'logoutToken';
}
- public function getDescription() {
- return 'This module is used to logout and clear session data';
+ public function isReadMode() {
+ return false;
}
- protected function getExamples() {
- return array(
- 'api.php?action=logout'
- );
+ protected function getExamplesMessages() {
+ return [
+ 'action=logout&token=123ABC'
+ => 'apihelp-logout-example-logout',
+ ];
}
- public function getVersion() {
- return __CLASS__ . ': $Id: ApiLogout.php 70647 2010-08-07 19:59:42Z ialex $';
+ public function getHelpUrls() {
+ return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Logout';
}
}