A service class for checking permissions To obtain an instance, use MediaWikiServices::getInstance()->getPermissionManager(). More...

Collaboration diagram for MediaWiki\Permissions\PermissionManager:

[legend]

Public Member Functions
	__construct (ServiceOptions $options, SpecialPageFactory $specialPageFactory, NamespaceInfo $nsInfo, GroupPermissionsLookup $groupPermissionsLookup, UserGroupManager $userGroupManager, BlockErrorFormatter $blockErrorFormatter, HookContainer $hookContainer, UserCache $userCache, RedirectLookup $redirectLookup)

	addTemporaryUserRights (UserIdentity $user, $rights)
	Add temporary user rights, only valid for the current scope. More...

	getAllPermissions ()
	Get a list of all available permissions. More...

	getGroupPermissions ( $groups)
	Get the permissions associated with a given list of groups. More...

	getGroupsWithPermission ( $role)
	Get all the groups who have a given permission. More...

	getNamespaceRestrictionLevels ( $index, UserIdentity $user=null)
	Determine which restriction levels it makes sense to use in a namespace, optionally filtered by a user's rights. More...

	getPermissionErrors ( $action, User $user, LinkTarget $page, $rigor=self::RIGOR_SECURE, $ignoreErrors=[])
	Can $user perform $action on a page? More...

	getUserPermissions (UserIdentity $user)
	Get the permissions this user has. More...

	groupHasPermission ( $group, $role)
	Check, if the given group has the given permission. More...

	invalidateUsersRightsCache ( $user=null)
	Clears users permissions cache, if specific user is provided it tries to clear permissions cache only for provided user. More...

	isBlockedFrom (User $user, $page, $fromReplica=false)
	Check if user is blocked from editing a particular article. More...

	isEveryoneAllowed ( $right)
	Check if all users may be assumed to have the given permission. More...

	overrideUserRightsForTesting ( $user, $rights=[])
	Overrides user permissions cache. More...

	quickUserCan ( $action, User $user, LinkTarget $page)
	A convenience method for calling PermissionManager::userCan with PermissionManager::RIGOR_QUICK. More...

	userCan ( $action, User $user, LinkTarget $page, $rigor=self::RIGOR_SECURE)
	Can $user perform $action on a page? More...

	userHasAllRights (UserIdentity $user,... $actions)
	Check if user is allowed to make all actions. More...

	userHasAnyRight (UserIdentity $user,... $actions)
	Check if user is allowed to make any action. More...

	userHasRight (UserIdentity $user, $action='')
	Testing a permission. More...

Public Attributes
const	CONSTRUCTOR_OPTIONS

Private Member Functions
	checkActionPermissions ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check action permissions not already checked in checkQuickPermissions. More...

	checkCascadingSourcesRestrictions ( $action, UserIdentity $user, $errors, $rigor, $short, LinkTarget $page)
	Check restrictions on cascading pages. More...

	checkPageRestrictions ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check against page_restrictions table requirements on this page. More...

	checkPermissionHooks ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check various permission hooks. More...

	checkQuickPermissions ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Permissions checks that fail most often, and which are easiest to test. More...

	checkReadPermissions ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check that the user is allowed to read this page. More...

	checkSiteConfigPermissions ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check sitewide CSS/JSON/JS permissions. More...

	checkSpecialsAndNSPermissions ( $action, UserIdentity $user, $errors, $rigor, $short, LinkTarget $page)
	Check permissions on special pages & namespaces. More...

	checkUserBlock ( $action, User $user, $errors, $rigor, $short, LinkTarget $page)
	Check that the user isn't blocked from editing. More...

	checkUserConfigPermissions ( $action, UserIdentity $user, $errors, $rigor, $short, LinkTarget $page)
	Check CSS/JSON/JS sub-page permissions. More...

	getPermissionErrorsInternal ( $action, User $user, LinkTarget $page, $rigor=self::RIGOR_SECURE, $short=false)
	Can $user perform $action on a page? This is an internal function, with multiple levels of checks depending on performance needs; see $rigor below. More...

	getRightsCacheKey (UserIdentity $user)
	Gets a unique key for user rights cache. More...

	isNamespaceProtected ( $index, UserIdentity $user)
	Determines if $user is unable to edit pages in namespace because it has been protected. More...

	isSameSpecialPage ( $name, LinkTarget $page)
	Returns true if this title resolves to the named special page. More...

	missingPermissionError ( $action, $short)
	Get a description array when the user doesn't have the right to perform $action (i.e. More...

	resultToError ( $errors, $result)
	Add the resulting error code to the errors array. More...

	userCanEditRawHtmlPage (UserIdentity $user)
	Check if user is allowed to edit sitewide pages that contain raw HTML. More...

Private Attributes
string[] null	$allRights
	Cached results of getAllPermissions() More...

BlockErrorFormatter	$blockErrorFormatter

bool[]	$cachedRights = []
	Cached rights for isEveryoneAllowed, [ right => allowed ]. More...

	$coreRights
	Array of Strings Core rights. More...

GroupPermissionsLookup	$groupPermissionsLookup

HookRunner	$hookRunner

NamespaceInfo	$nsInfo

ServiceOptions	$options

RedirectLookup	$redirectLookup

SpecialPageFactory	$specialPageFactory

string[][][]	$temporaryUserRights = []
	Temporary user rights, valid for the current request only. More...

UserCache	$userCache

UserGroupManager	$userGroupManager

string[][]	$usersRights = []
	Cached user rights. More...

Detailed Description

A service class for checking permissions To obtain an instance, use MediaWikiServices::getInstance()->getPermissionManager().

Since: 1.33

Definition at line 52 of file PermissionManager.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Permissions\PermissionManager::__construct	(	ServiceOptions	$options,
		SpecialPageFactory	$specialPageFactory,
		NamespaceInfo	$nsInfo,
		GroupPermissionsLookup	$groupPermissionsLookup,
		UserGroupManager	$userGroupManager,
		BlockErrorFormatter	$blockErrorFormatter,
		HookContainer	$hookContainer,
		UserCache	$userCache,
		RedirectLookup	$redirectLookup
	)

Parameters

ServiceOptions	$options
SpecialPageFactory	$specialPageFactory
NamespaceInfo	$nsInfo
GroupPermissionsLookup	$groupPermissionsLookup
UserGroupManager	$userGroupManager
BlockErrorFormatter	$blockErrorFormatter
HookContainer	$hookContainer
UserCache	$userCache
RedirectLookup	$redirectLookup

Definition at line 223 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\$blockErrorFormatter, MediaWiki\Permissions\PermissionManager\$groupPermissionsLookup, MediaWiki\Permissions\PermissionManager\$nsInfo, MediaWiki\Permissions\PermissionManager\$options, MediaWiki\Permissions\PermissionManager\$redirectLookup, MediaWiki\Permissions\PermissionManager\$specialPageFactory, MediaWiki\Permissions\PermissionManager\$userCache, MediaWiki\Permissions\PermissionManager\$userGroupManager, and MediaWiki\Config\ServiceOptions\assertRequiredOptions().

Member Function Documentation

◆ addTemporaryUserRights()

MediaWiki\Permissions\PermissionManager::addTemporaryUserRights	(	UserIdentity	$user,
			$rights
	)

Add temporary user rights, only valid for the current scope.

This is meant for making it possible to programatically trigger certain actions that the user wouldn't be able to trigger themselves; e.g. allow users without the bot right to make bot-flagged actions through certain special pages. Returns a "scope guard" variable; whenever that variable goes out of scope or is consumed via ScopedCallback::consume(), the temporary rights are revoked.

Since: 1.34

Parameters

UserIdentity	$user
string \| string[]	$rights

Returns: ScopedCallback

Definition at line 1736 of file PermissionManager.php.

References MediaWiki\User\UserIdentity\getId().

◆ checkActionPermissions()

MediaWiki\Permissions\PermissionManager::checkActionPermissions	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check action permissions not already checked in checkQuickPermissions.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 1062 of file PermissionManager.php.

References MediaWiki\$action, $title, $wgLang, MediaWiki\Permissions\PermissionManager\checkCascadingSourcesRestrictions(), MediaWiki\Permissions\PermissionManager\checkPageRestrictions(), MediaWiki\Permissions\PermissionManager\getPermissionErrorsInternal(), Title\newFromLinkTarget(), MediaWiki\Permissions\PermissionManager\userHasRight(), and wfMessage().

◆ checkCascadingSourcesRestrictions()

MediaWiki\Permissions\PermissionManager::checkCascadingSourcesRestrictions	(		$action,
		UserIdentity	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check restrictions on cascading pages.

Parameters

string	$action	The action to check
UserIdentity	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 1005 of file PermissionManager.php.

References MediaWiki\$action, $title, Title\newFromLinkTarget(), and MediaWiki\Permissions\PermissionManager\userHasAllRights().

Referenced by MediaWiki\Permissions\PermissionManager\checkActionPermissions().

◆ checkPageRestrictions()

MediaWiki\Permissions\PermissionManager::checkPageRestrictions	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check against page_restrictions table requirements on this page.

The user must possess all required rights for this action.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 955 of file PermissionManager.php.

References MediaWiki\$action, $title, Title\newFromLinkTarget(), and MediaWiki\Permissions\PermissionManager\userHasRight().

Referenced by MediaWiki\Permissions\PermissionManager\checkActionPermissions().

◆ checkPermissionHooks()

MediaWiki\Permissions\PermissionManager::checkPermissionHooks	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check various permission hooks.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 491 of file PermissionManager.php.

References MediaWiki\$action, $title, Title\newFromLinkTarget(), and MediaWiki\Permissions\PermissionManager\resultToError().

◆ checkQuickPermissions()

MediaWiki\Permissions\PermissionManager::checkQuickPermissions	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Permissions checks that fail most often, and which are easiest to test.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 852 of file PermissionManager.php.

References MediaWiki\$action, $title, MediaWiki\Permissions\PermissionManager\groupHasPermission(), User\isAnon(), MediaWiki\Permissions\PermissionManager\missingPermissionError(), Title\newFromLinkTarget(), NS_CATEGORY, NS_FILE, NS_USER, and MediaWiki\Permissions\PermissionManager\userHasRight().

◆ checkReadPermissions()

MediaWiki\Permissions\PermissionManager::checkReadPermissions	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check that the user is allowed to read this page.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 567 of file PermissionManager.php.

References MediaWiki\$action, $title, SpecialPage\getTitleFor(), MediaWiki\Permissions\PermissionManager\isEveryoneAllowed(), MediaWiki\Permissions\PermissionManager\isSameSpecialPage(), MediaWiki\Permissions\PermissionManager\missingPermissionError(), Title\newFromLinkTarget(), NS_MAIN, and MediaWiki\Permissions\PermissionManager\userHasRight().

◆ checkSiteConfigPermissions()

MediaWiki\Permissions\PermissionManager::checkSiteConfigPermissions	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check sitewide CSS/JSON/JS permissions.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 1226 of file PermissionManager.php.

References MediaWiki\$action, $title, and Title\newFromLinkTarget().

◆ checkSpecialsAndNSPermissions()

MediaWiki\Permissions\PermissionManager::checkSpecialsAndNSPermissions	(		$action,
		UserIdentity	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check permissions on special pages & namespaces.

Parameters

string	$action	The action to check
UserIdentity	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 1182 of file PermissionManager.php.

References MediaWiki\$action, $title, MediaWiki\Permissions\PermissionManager\isNamespaceProtected(), Title\newFromLinkTarget(), NS_MAIN, NS_MEDIAWIKI, NS_SPECIAL, and wfMessage().

◆ checkUserBlock()

MediaWiki\Permissions\PermissionManager::checkUserBlock	(		$action,
		User	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check that the user isn't blocked from editing.

Parameters

string	$action	The action to check
User	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 706 of file PermissionManager.php.

References MediaWiki\$action, MediaWiki\$context, $title, Action\exists(), Action\factory(), User\getBlock(), IContextSource\getLanguage(), RequestContext\getMain(), IContextSource\getRequest(), User\getRequest(), IContextSource\getUser(), MediaWiki\Permissions\PermissionManager\isBlockedFrom(), User\isEmailConfirmed(), Title\newFromLinkTarget(), MediaWiki\Block\DatabaseBlock\newFromTarget(), Article\newFromTitle(), and MediaWiki\Permissions\PermissionManager\userHasRight().

◆ checkUserConfigPermissions()

MediaWiki\Permissions\PermissionManager::checkUserConfigPermissions	(		$action,
		UserIdentity	$user,
			$errors,
			$rigor,
			$short,
		LinkTarget	$page
	)

private

Check CSS/JSON/JS sub-page permissions.

Parameters

string	$action	The action to check
UserIdentity	$user	User to check
array	$errors	List of current errors
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Short circuit on first error
LinkTarget	$page

Returns: array List of errors

Definition at line 1282 of file PermissionManager.php.

References MediaWiki\$action, $title, MediaWiki\User\UserIdentity\getName(), Title\newFromLinkTarget(), and NS_USER.

◆ getAllPermissions()

MediaWiki\Permissions\PermissionManager::getAllPermissions ( )

Get a list of all available permissions.

Since: 1.34

Returns: string[] Array of permission names

Definition at line 1602 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\$allRights, and MediaWiki\Permissions\PermissionManager\$coreRights.

◆ getGroupPermissions()

MediaWiki\Permissions\PermissionManager::getGroupPermissions ( $groups )

Get the permissions associated with a given list of groups.

Since: 1.34

Deprecated:: since 1.36 Use GroupPermissionsLookup instead

Parameters

string[] $groups internal group names

Returns: string[] permission key names for given groups combined

Definition at line 1519 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\getUserPermissions().

◆ getGroupsWithPermission()

MediaWiki\Permissions\PermissionManager::getGroupsWithPermission ( $role )

Get all the groups who have a given permission.

Since: 1.34

Deprecated:: since 1.36, use GroupPermissionsLookup instead.

Parameters

string $role Role to check

Returns: string[] internal group names with the given permission

Definition at line 1532 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\getNamespaceRestrictionLevels().

◆ getNamespaceRestrictionLevels()

MediaWiki\Permissions\PermissionManager::getNamespaceRestrictionLevels	(		$index,
		UserIdentity	$user = `null`
	)

Determine which restriction levels it makes sense to use in a namespace, optionally filtered by a user's rights.

Parameters

int	$index	Namespace ID (index) to check
UserIdentity \| null	$user	User to check

Returns: string[]

Definition at line 1639 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\getGroupsWithPermission(), and MediaWiki\Permissions\PermissionManager\userHasRight().

◆ getPermissionErrors()

MediaWiki\Permissions\PermissionManager::getPermissionErrors	(		$action,
		User	$user,
		LinkTarget	$page,
			$rigor = `self::RIGOR_SECURE`,
			$ignoreErrors = `[]`
	)

Can $user perform $action on a page?

Todo:: FIXME: This does not check throttles (User::pingLimiter()).

Parameters

string	$action	Action that permission needs to be checked for
User	$user	User to check
LinkTarget	$page
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
string[]	$ignoreErrors	Set this to a list of message keys whose corresponding errors may be ignored.

Returns: array[] Array of arrays of the arguments to wfMessage to explain permissions problems.

Definition at line 303 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\getPermissionErrorsInternal().

◆ getPermissionErrorsInternal()

MediaWiki\Permissions\PermissionManager::getPermissionErrorsInternal	(		$action,
		User	$user,
		LinkTarget	$page,
			$rigor = `self::RIGOR_SECURE`,
			$short = `false`
	)

private

Can $user perform $action on a page? This is an internal function, with multiple levels of checks depending on performance needs; see $rigor below.

It does not check wfReadOnly().

Parameters

string	$action	Action that permission needs to be checked for
User	$user	User to check
LinkTarget	$page
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed
bool	$short	Set this to true to stop after the first permission error.

Returns: array[] Array of arrays of the arguments to wfMessage to explain permissions problems.

Exceptions

Exception

Definition at line 386 of file PermissionManager.php.

References MediaWiki\$action.

Referenced by MediaWiki\Permissions\PermissionManager\checkActionPermissions(), MediaWiki\Permissions\PermissionManager\getPermissionErrors(), and MediaWiki\Permissions\PermissionManager\userCan().

◆ getRightsCacheKey()

MediaWiki\Permissions\PermissionManager::getRightsCacheKey ( UserIdentity $user )

private

Gets a unique key for user rights cache.

Parameters

UserIdentity $user

Returns: string

Definition at line 1487 of file PermissionManager.php.

References MediaWiki\User\UserIdentity\isRegistered().

Referenced by MediaWiki\Permissions\PermissionManager\getUserPermissions(), MediaWiki\Permissions\PermissionManager\invalidateUsersRightsCache(), and MediaWiki\Permissions\PermissionManager\overrideUserRightsForTesting().

◆ getUserPermissions()

MediaWiki\Permissions\PermissionManager::getUserPermissions ( UserIdentity $user )

Get the permissions this user has.

Since: 1.34

Parameters

UserIdentity $user

Returns: string[] permission names

Definition at line 1415 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\getGroupPermissions(), MediaWiki\User\UserIdentity\getId(), MediaWiki\Permissions\PermissionManager\getRightsCacheKey(), and User\newFromIdentity().

Referenced by MediaWiki\Permissions\PermissionManager\userHasRight().

◆ groupHasPermission()

MediaWiki\Permissions\PermissionManager::groupHasPermission	(	$group,
		$role
	)

Check, if the given group has the given permission.

If you're wanting to check whether all users have a permission, use PermissionManager::isEveryoneAllowed() instead. That properly checks if it's revoked from anyone.

Since: 1.34

Deprecated:: since 1.36 Use GroupPermissionsLookup instead

Parameters

string	$group	Group to check
string	$role	Role to check

Returns: bool

Definition at line 1506 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\checkQuickPermissions().

◆ invalidateUsersRightsCache()

MediaWiki\Permissions\PermissionManager::invalidateUsersRightsCache ( $user = null )

Clears users permissions cache, if specific user is provided it tries to clear permissions cache only for provided user.

Since: 1.34

Parameters

UserIdentity | null $user

Definition at line 1473 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\getRightsCacheKey().

◆ isBlockedFrom()

MediaWiki\Permissions\PermissionManager::isBlockedFrom	(	User	$user,
			$page,
			$fromReplica = `false`
	)

Check if user is blocked from editing a particular article.

If the user does not have a block, this will return false.

Parameters

User	$user
PageIdentity \| LinkTarget	$page	Title to check
bool	$fromReplica	Whether to check the replica DB instead of the primary DB

Returns: bool

Definition at line 337 of file PermissionManager.php.

References $title, Title\castFromLinkTarget(), Title\castFromPageIdentity(), User\getBlock(), User\getTalkPage(), and User\isHidden().

Referenced by MediaWiki\Permissions\PermissionManager\checkUserBlock().

◆ isEveryoneAllowed()

MediaWiki\Permissions\PermissionManager::isEveryoneAllowed ( $right )

Check if all users may be assumed to have the given permission.

We generally assume so if the right is granted to '*' and isn't revoked on any group. It doesn't attempt to take grants or other extension limitations on rights into account in the general case, though, as that would require it to always return false and defeat the purpose. Specifically, session-based rights restrictions (such as OAuth or bot passwords) are applied based on the current session.

Parameters

string $right Right to check

Returns: bool

Since: 1.34

Definition at line 1551 of file PermissionManager.php.

References MediaWiki\Session\SessionManager\getGlobalSession().

Referenced by MediaWiki\Permissions\PermissionManager\checkReadPermissions().

◆ isNamespaceProtected()

MediaWiki\Permissions\PermissionManager::isNamespaceProtected	(		$index,
		UserIdentity	$user
	)

private

Determines if $user is unable to edit pages in namespace because it has been protected.

Parameters

int	$index
UserIdentity	$user

Returns: bool

Definition at line 1623 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\userHasAllRights().

Referenced by MediaWiki\Permissions\PermissionManager\checkSpecialsAndNSPermissions().

◆ isSameSpecialPage()

MediaWiki\Permissions\PermissionManager::isSameSpecialPage	(		$name,
		LinkTarget	$page
	)

private

Returns true if this title resolves to the named special page.

Parameters

string	$name	The special page name
LinkTarget	$page

Returns: bool

Definition at line 679 of file PermissionManager.php.

References MediaWiki\Linker\LinkTarget\getDBkey(), MediaWiki\Linker\LinkTarget\getNamespace(), and NS_SPECIAL.

Referenced by MediaWiki\Permissions\PermissionManager\checkReadPermissions().

◆ missingPermissionError()

MediaWiki\Permissions\PermissionManager::missingPermissionError	(	$action,
		$short
	)

private

Get a description array when the user doesn't have the right to perform $action (i.e.

when User::isAllowed() returns false)

Parameters

string	$action	The action to check
bool	$short	Short circuit on first error

Returns: array Array containing an error message key and any parameters

Definition at line 660 of file PermissionManager.php.

References MediaWiki\$action, and User\newFatalPermissionDeniedStatus().

Referenced by MediaWiki\Permissions\PermissionManager\checkQuickPermissions(), and MediaWiki\Permissions\PermissionManager\checkReadPermissions().

◆ overrideUserRightsForTesting()

MediaWiki\Permissions\PermissionManager::overrideUserRightsForTesting	(	$user,
		$rights = `[]`
	)

Overrides user permissions cache.

Since: 1.34

Parameters

User	$user
string[] \| string	$rights

Exceptions

Exception

Definition at line 1755 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\getRightsCacheKey().

◆ quickUserCan()

MediaWiki\Permissions\PermissionManager::quickUserCan	(		$action,
		User	$user,
		LinkTarget	$page
	)

A convenience method for calling PermissionManager::userCan with PermissionManager::RIGOR_QUICK.

Suitable for use for nonessential UI controls in common cases, but not for functional access control. May provide false positives, but should never provide a false negative.

See also: PermissionManager::userCan()

Parameters

string	$action
User	$user
LinkTarget	$page

Returns: bool

Definition at line 282 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\userCan().

◆ resultToError()

MediaWiki\Permissions\PermissionManager::resultToError	(	$errors,
		$result
	)

private

Add the resulting error code to the errors array.

Parameters

array	$errors	List of current errors
array \| string \| MessageSpecifier \| false	$result	Result of errors

Returns: array List of errors

Definition at line 531 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\checkPermissionHooks().

◆ userCan()

MediaWiki\Permissions\PermissionManager::userCan	(		$action,
		User	$user,
		LinkTarget	$page,
			$rigor = `self::RIGOR_SECURE`
	)

Can $user perform $action on a page?

The method replaced Title::userCan() The $user parameter need to be superseded by UserIdentity value in future The $title parameter need to be superseded by PageIdentity value in future

Parameters

string	$action
User	$user
LinkTarget	$page
string	$rigor	One of PermissionManager::RIGOR_ constants RIGOR_QUICK : does cheap permission checks from replica DBs (usable for GUI creation) RIGOR_FULL : does cheap and expensive checks possibly from a replica DB RIGOR_SECURE : does cheap and expensive checks, using the primary DB as needed

Returns: bool

Definition at line 263 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\getPermissionErrorsInternal().

Referenced by MediaWiki\Permissions\PermissionManager\quickUserCan().

◆ userCanEditRawHtmlPage()

MediaWiki\Permissions\PermissionManager::userCanEditRawHtmlPage ( UserIdentity $user )

private

Check if user is allowed to edit sitewide pages that contain raw HTML.

Pages listed in $wgRawHtmlMessages allow raw HTML which can be used to deploy CSS or JS code to all users so both rights are required to edit them.

Parameters

UserIdentity $user

Returns: bool True if user has both rights

Definition at line 1718 of file PermissionManager.php.

References MediaWiki\Permissions\PermissionManager\userHasAllRights().

◆ userHasAllRights()

MediaWiki\Permissions\PermissionManager::userHasAllRights	(	UserIdentity	$user,
			$actions
	)

Check if user is allowed to make all actions.

Parameters

UserIdentity	$user
	string	...$actions

Returns: bool True if user is allowed to perform all of the given actions

Since: 1.34

Definition at line 1397 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\userHasRight().

Referenced by MediaWiki\Permissions\PermissionManager\checkCascadingSourcesRestrictions(), MediaWiki\Permissions\PermissionManager\isNamespaceProtected(), and MediaWiki\Permissions\PermissionManager\userCanEditRawHtmlPage().

◆ userHasAnyRight()

MediaWiki\Permissions\PermissionManager::userHasAnyRight	(	UserIdentity	$user,
			$actions
	)

Check if user is allowed to make any action.

Parameters

UserIdentity	$user
	string	...$actions

Returns: bool True if user is allowed to perform any of the given actions

Since: 1.34

Definition at line 1380 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\userHasRight().

◆ userHasRight()

MediaWiki\Permissions\PermissionManager::userHasRight	(	UserIdentity	$user,
			$action = `''`
	)

Testing a permission.

Since: 1.34

Parameters

UserIdentity	$user
string	$action

Returns: bool

Definition at line 1363 of file PermissionManager.php.

References MediaWiki\$action, and MediaWiki\Permissions\PermissionManager\getUserPermissions().

Member Data Documentation

◆ $allRights

string [] null MediaWiki\Permissions\PermissionManager::$allRights

private

Cached results of getAllPermissions()

Definition at line 99 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\getAllPermissions().

◆ $blockErrorFormatter

BlockErrorFormatter MediaWiki\Permissions\PermissionManager::$blockErrorFormatter

private

Definition at line 102 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $cachedRights

bool [] MediaWiki\Permissions\PermissionManager::$cachedRights = []

private

Cached rights for isEveryoneAllowed, [ right => allowed ].

Definition at line 120 of file PermissionManager.php.

◆ $coreRights

MediaWiki\Permissions\PermissionManager::$coreRights

private

Initial value:

= [
        'apihighlimits',
        'applychangetags',
        'autoconfirmed',
        'autocreateaccount',
        'autopatrol',
        'bigdelete',
        'block',
        'blockemail',
        'bot',
        'browsearchive',
        'changetags',
        'createaccount',
        'createpage',
        'createtalk',
        'delete',
        'delete-redirect',
        'deletechangetags',
        'deletedhistory',
        'deletedtext',
        'deletelogentry',
        'deleterevision',
        'edit',
        'editcontentmodel',
        'editinterface',
        'editprotected',
        'editmyoptions',
        'editmyprivateinfo',
        'editmyusercss',
        'editmyuserjson',
        'editmyuserjs',
        'editmyuserjsredirect',
        'editmywatchlist',
        'editsemiprotected',
        'editsitecss',
        'editsitejson',
        'editsitejs',
        'editusercss',
        'edituserjson',
        'edituserjs',
        'hideuser',
        'import',
        'importupload',
        'ipblock-exempt',
        'managechangetags',
        'markbotedits',
        'mergehistory',
        'minoredit',
        'move',
        'movefile',
        'move-categorypages',
        'move-rootuserpages',
        'move-subpages',
        'nominornewtalk',
        'noratelimit',
        'override-export-depth',
        'pagelang',
        'patrol',
        'patrolmarks',
        'protect',
        'purge',
        'read',
        'reupload',
        'reupload-own',
        'reupload-shared',
        'rollback',
        'sendemail',
        'siteadmin',
        'suppressionlog',
        'suppressredirect',
        'suppressrevision',
        'unblockself',
        'undelete',
        'unwatchedpages',
        'upload',
        'upload_by_url',
        'userrights',
        'userrights-interwiki',
        'viewmyprivateinfo',
        'viewmywatchlist',
        'viewsuppressed',
        'writeapi',
    ]

Array of Strings Core rights.

Each of these should have a corresponding message of the form "right-$right".

Definition at line 128 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\getAllPermissions().

◆ $groupPermissionsLookup

GroupPermissionsLookup MediaWiki\Permissions\PermissionManager::$groupPermissionsLookup

private

Definition at line 93 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $hookRunner

HookRunner MediaWiki\Permissions\PermissionManager::$hookRunner

private

Definition at line 105 of file PermissionManager.php.

◆ $nsInfo

NamespaceInfo MediaWiki\Permissions\PermissionManager::$nsInfo

private

Definition at line 90 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $options

ServiceOptions MediaWiki\Permissions\PermissionManager::$options

private

Definition at line 81 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $redirectLookup

RedirectLookup MediaWiki\Permissions\PermissionManager::$redirectLookup

private

Definition at line 87 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $specialPageFactory

SpecialPageFactory MediaWiki\Permissions\PermissionManager::$specialPageFactory

private

Definition at line 84 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $temporaryUserRights

string [][][] MediaWiki\Permissions\PermissionManager::$temporaryUserRights = []

private

Temporary user rights, valid for the current request only.

userid => override group => rights

Definition at line 117 of file PermissionManager.php.

◆ $userCache

UserCache MediaWiki\Permissions\PermissionManager::$userCache

private

Definition at line 108 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $userGroupManager

UserGroupManager MediaWiki\Permissions\PermissionManager::$userGroupManager

private

Definition at line 96 of file PermissionManager.php.

Referenced by MediaWiki\Permissions\PermissionManager\__construct().

◆ $usersRights

string [][] MediaWiki\Permissions\PermissionManager::$usersRights = []

private

Cached user rights.

Definition at line 111 of file PermissionManager.php.

◆ CONSTRUCTOR_OPTIONS

const MediaWiki\Permissions\PermissionManager::CONSTRUCTOR_OPTIONS

Initial value:

= [
        'WhitelistRead',
        'WhitelistReadRegexp',
        'EmailConfirmToEdit',
        'BlockDisablesLogin',
        'EnablePartialActionBlocks',
        'GroupPermissions',
        'RevokePermissions',
        'AvailableRights',
        'NamespaceProtection',
        'RestrictionLevels',
        'DeleteRevisionsLimit',
    ]

Access: internal: For use by ServiceWiring

Definition at line 66 of file PermissionManager.php.

The documentation for this class was generated from the following file:

includes/Permissions/PermissionManager.php

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addTemporaryUserRights()

◆ checkActionPermissions()

◆ checkCascadingSourcesRestrictions()

◆ checkPageRestrictions()

◆ checkPermissionHooks()

◆ checkQuickPermissions()

◆ checkReadPermissions()

◆ checkSiteConfigPermissions()

◆ checkSpecialsAndNSPermissions()

◆ checkUserBlock()

◆ checkUserConfigPermissions()

◆ getAllPermissions()

◆ getGroupPermissions()

◆ getGroupsWithPermission()

◆ getNamespaceRestrictionLevels()

◆ getPermissionErrors()

◆ getPermissionErrorsInternal()

◆ getRightsCacheKey()

◆ getUserPermissions()

◆ groupHasPermission()

◆ invalidateUsersRightsCache()

◆ isBlockedFrom()

◆ isEveryoneAllowed()

◆ isNamespaceProtected()

◆ isSameSpecialPage()

◆ missingPermissionError()

◆ overrideUserRightsForTesting()

◆ quickUserCan()

◆ resultToError()

◆ userCan()

◆ userCanEditRawHtmlPage()

◆ userHasAllRights()

◆ userHasAnyRight()

◆ userHasRight()

Member Data Documentation

◆ $allRights

◆ $blockErrorFormatter

◆ $cachedRights

◆ $coreRights

◆ $groupPermissionsLookup

◆ $hookRunner

◆ $nsInfo

◆ $options

◆ $redirectLookup

◆ $specialPageFactory

◆ $temporaryUserRights

◆ $userCache

◆ $userGroupManager

◆ $usersRights

◆ CONSTRUCTOR_OPTIONS