API:限制API使用
Appearance
Outdated translations are marked like this.
本页是MediaWiki Action API帮助文档的一部份。 |
此处有几种方式来对用户组用户限制使用(某些)API或完全禁用它。 其中的某些需要修改用户权限。
限制访问写入API
您可以通过禁用writeapi权限来拒绝某些组使用写入API的权限。 默认情况下,所有用户组都拥有writeapi权限。
禁用模块
您可以对所有用户单独禁用模块通过在LocalSettings.php添加一行内容。 究竟要添加什么要取决于禁用的模块类型:
- 对于
action=
模块,应添加$wgAPIModules ['modulename'] = 'ApiDisabled';
。 - 对于
prop=
模块,应添加$wgAPIPropModules ['modulename'] = 'ApiQueryDisabled';
。 - 对于
list=
模块,应添加$wgAPIListModules ['modulename'] = 'ApiQueryDisabled';
。 - 对于
meta=
模块,应添加$wgAPIMetaModules ['modulename'] = 'ApiQueryDisabled';
。
示例
禁止任何不是管理员的用户使用action=edit
:
if ( !in_array( 'sysop', $wgUser->getGroups() ) ) {
$wgAPIModules['edit'] = 'ApiDisabled';
}
要限制API操作的访问权限,为ApiCheckCanExecute添加下面的钩子:
static function onApiCheckCanExecute( $module, $user, &$message ) {
$moduleName = $module->getModuleName();
if (
$moduleName == 'action' &&
!in_array( 'right', $user->getRights() )
) {
$message = 'apierror-action-notallowed';
return false;
}
return true;
}
将'action'
, 'right'
和'apierror-action-notallowed'
替换为适当的值。