2020-03-03 22:50:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Api\Hook;
|
|
|
|
|
|
2020-03-16 23:31:05 +00:00
|
|
|
use ApiBase;
|
|
|
|
|
use IApiMessage;
|
|
|
|
|
use Message;
|
|
|
|
|
use User;
|
|
|
|
|
|
2020-03-03 22:50:34 +00:00
|
|
|
/**
|
2020-07-13 09:05:49 +00:00
|
|
|
* @stable to implement
|
2020-03-03 22:50:34 +00:00
|
|
|
* @ingroup Hooks
|
|
|
|
|
*/
|
|
|
|
|
interface ApiCheckCanExecuteHook {
|
|
|
|
|
/**
|
2020-03-16 23:31:05 +00:00
|
|
|
* This hook is called during ApiMain::checkCanExecute. Use this hook to further
|
|
|
|
|
* authenticate and authorize API clients before executing the module.
|
2020-03-03 22:50:34 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param ApiBase $module Module object
|
|
|
|
|
* @param User $user Current user
|
|
|
|
|
* @param IApiMessage|Message|string|array &$message API message to die with.
|
|
|
|
|
* Specific values accepted depend on the MediaWiki version:
|
2020-03-03 22:50:34 +00:00
|
|
|
* * 1.29+: IApiMessage, Message, string message key, or key+parameters array to
|
|
|
|
|
* pass to ApiBase::dieWithError().
|
|
|
|
|
* * 1.27+: IApiMessage, or a key or key+parameters in ApiBase::$messageMap.
|
|
|
|
|
* * Earlier: A key or key+parameters in ApiBase::$messageMap.
|
2020-03-16 23:31:05 +00:00
|
|
|
* @return bool|void True or no return value to continue, or false and set a
|
|
|
|
|
* message to cancel the request
|
2020-03-03 22:50:34 +00:00
|
|
|
*/
|
|
|
|
|
public function onApiCheckCanExecute( $module, $user, &$message );
|
|
|
|
|
}
|