MediaWiki\User\UserIdentity Interface Reference

Interface for objects representing user identity. More...

Inheritance diagram for MediaWiki\User\UserIdentity:

Collaboration diagram for MediaWiki\User\UserIdentity:

Public Member Functions
	equals (?UserIdentity $user)
	getId ( $wikiId=self::LOCAL)
	getName ()
	isRegistered ()
Public Member Functions inherited from MediaWiki\DAO\WikiAwareEntity
	assertWiki ( $wikiId)
	Throws if $wikiId is different from the return value of getWikiId().
	getWikiId ()
	Get the ID of the wiki this page belongs to.

Detailed Description

Interface for objects representing user identity.

This represents the identity of a user in the context of page revisions and log entries.

Note

Starting MediaWiki 1.37, UserIdentity objects should no longer expose an actor ID. The actor ID is considered a storage layer optimization and should not be exposed to and used by application logic. Storage layer code should use ActorNormalization to get an actor ID for a UserIdentity.

Since

1.31

Definition at line 39 of file UserIdentity.php.

Member Function Documentation

equals()

MediaWiki\User\UserIdentity::equals

(

?UserIdentity

$user

)

Since

1.32

Parameters

UserIdentity | null

$user

Returns

bool

Implemented in User, MediaWiki\User\UserIdentityValue, and UserRightsProxy.

Referenced by MediaWiki\Block\BlockPermissionChecker\checkBlockPermissions().

getId()

MediaWiki\User\UserIdentity::getId

(

$wikiId = self::LOCAL

)

Since

1.31

Parameters

string | false

$wikiId

The wiki ID expected by the caller

Returns

int The user ID. May be 0 for anonymous users or for users with no local account.

Implemented in User, MediaWiki\User\UserIdentityValue, and UserRightsProxy.

Referenced by UserEditCountUpdate\__construct(), MediaWiki\User\ActorCache\add(), MediaWiki\Permissions\PermissionManager\addTemporaryUserRights(), MediaWiki\Block\BlockPermissionChecker\checkBlockPermissions(), MediaWiki\User\UserEditTracker\clearUserEditCache(), WatchedItemStore\countUnreadNotifications(), WikiPage\doUpdateRestrictions(), ApiBlock\execute(), ActorMigrationBase\getInsertValues(), ActorMigrationBase\getInsertValuesWithTempTable(), MediaWiki\Watchlist\WatchlistManager\getTitleNotificationTimestamp(), LogFormatter\makeUserLink(), RecentChange\newForCategorization(), ClearUserWatchlistJob\newForUser(), WatchedItemStore\resetAllNotificationTimestampsForUser(), MediaWiki\User\UserEditTracker\setCachedUserEditCount(), and UserrightsPage\userCanChangeRights().

getName()

MediaWiki\User\UserIdentity::getName

(

)

Since

1.31

Returns

string The user's logical name. May be an IPv4 or IPv6 address for anonymous users.

Implemented in User, MediaWiki\User\UserIdentityValue, and UserRightsProxy.

Referenced by ContribsPager\__construct(), MediaWiki\User\ActorCache\add(), MediaWiki\Storage\PageEditStash\checkCache(), PasswordPolicyChecks\checkPasswordCannotBeSubstringInUsername(), PasswordPolicyChecks\checkPasswordCannotMatchDefaults(), WikiPage\doEditUpdates(), ApiQueryUserInfo\getCentralUserInfo(), ActorMigrationBase\getInsertValues(), ActorMigrationBase\getInsertValuesWithTempTable(), MediaWiki\User\StaticUserOptionsLookup\getOptions(), SpecialBlock\getTargetUserTitle(), MediaWiki\User\UserGroupManager\getUserImplicitGroups(), Parser\getUserSig(), MediaWiki\Storage\DerivedPageDataUpdater\isReusableFor(), LogFormatter\makeUserLink(), RecentChange\newForCategorization(), MediaWiki\Storage\DerivedPageDataUpdater\prepareContent(), WikiPage\prepareContentForEdit(), and MediaWiki\Storage\PageUpdater\updateAuthor().

isRegistered()

MediaWiki\User\UserIdentity::isRegistered

(

)

Since

1.34

Returns

bool True if user is registered on this wiki, i.e., has a user ID. False if user is anonymous or has no local account (which can happen when importing). This must be equivalent to getId() != 0 and is provided for code readability.

Implemented in User, MediaWiki\User\UserIdentityValue, and UserRightsProxy.

Referenced by UserEditCountUpdate\__construct(), MediaWiki\Storage\PageEditStash\checkCache(), MediaWiki\User\UserEditTracker\clearUserEditCache(), MediaWiki\Watchlist\WatchlistManager\getTitleNotificationTimestamp(), MediaWiki\Block\BlockManager\getUserBlock(), MediaWiki\User\UserGroupManager\getUserImplicitGroups(), Parser\getUserSig(), WatchedItemStore\getWatchedItem(), WatchedItemQueryService\getWatchedItemsForUser(), MediaWiki\User\UserEditTracker\incrementUserEditCount(), WatchedItemStore\loadWatchedItemsBatch(), LogFormatter\makeUserLink(), WatchedItemStore\resetAllNotificationTimestampsForUser(), and MediaWiki\User\UserEditTracker\setCachedUserEditCount().

---

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

• includes/user/UserIdentity.php