MediaWiki  master
User Class Reference

The User object encapsulates all of the user-specific settings (user_id, name, rights, password, email address, options, last login time). More...

Inheritance diagram for User:
Collaboration diagram for User:

List of all members.

Public Member Functions

 __construct ()
 Lightweight constructor for an anonymous user.
 __toString ()
 addAutopromoteOnceGroups ($event)
 Add the user to the group if he/she meets given criteria.
 addGroup ($group)
 Add the user to the given group.
 addNewUserLogEntry ($byEmail=false, $reason= '')
 Add a newuser log entry for this user.
 addNewUserLogEntryAutoCreate ()
 Add an autocreate newuser log entry for this user Used by things like CentralAuth and perhaps other authplugins.
 addToDatabase ()
 Add this existing user object to the database.
 addWatch ($title)
 Watch an article.
 blockedBy ()
 If user is blocked, return the name of the user who placed the block.
 blockedFor ()
 If user is blocked, return the specified reason for the block.
 canReceiveEmail ()
 Is this user allowed to receive e-mails within limits of current site configuration?
 canSendEmail ()
 Is this user allowed to send e-mails within limits of current site configuration?
 changeableGroups ()
 Returns an array of groups that this user can add and remove.
 checkPassword ($password)
 Check to see if the given clear-text password is one of the accepted passwords.
 checkTemporaryPassword ($plaintext)
 Check if the given clear-text password matches the temporary password sent by e-mail for password reset operations.
 clearAllNotifications ()
 Resets all of the given user's page-change notification timestamps.
 clearInstanceCache ($reloadFrom=false)
 Clear various cached data stored in this object.
 clearNotification (&$title)
 Clear the user's notification timestamp for the given title.
 confirmEmail ()
 Mark the e-mail address confirmed.
 doLogout ()
 Clear the user's cookies and session, and reset the instance cache.
 editToken ($salt= '', $request=null)
 Alias for getEditToken.
 getAutomaticGroups ($recache=false)
 Get the list of implicit group memberships this user has.
 getBlock ($bFromSlave=true)
 Get the block affecting the user, or null if the user is not blocked.
 getBlockId ()
 If user is blocked, return the ID for the block.
 getBoolOption ($oname)
 Get the user's current setting for a given option, as a boolean value.
 getDatePreference ()
 Get the user's preferred date format.
 getEditCount ()
 Get the user's edit count.
 getEditToken ($salt= '', $request=null)
 Initialize (if necessary) and return a session token value which can be used in edit forms to show that the user's login credentials aren't being hijacked with a foreign form submission.
 getEffectiveGroups ($recache=false)
 Get the list of implicit group memberships this user has.
 getEmail ()
 Get the user's e-mail address.
 getEmailAuthenticationTimestamp ()
 Get the timestamp of the user's e-mail authentication.
 getFirstEditTimestamp ()
 Get the timestamp of the first edit.
 getFormerGroups ()
 Returns the groups the user has belonged to.
 getGroups ()
 Get the list of explicit group memberships this user has.
 getId ()
 Get the user's ID.
 getIntOption ($oname, $defaultOverride=0)
 Get the user's current setting for a given option, as a boolean value.
 getName ()
 Get the user name, or the IP of an anonymous user.
 getNewMessageLinks ()
 Return the talk page(s) this user has new messages on.
 getNewtalk ()
 Check if the user has new messages.
 getOption ($oname, $defaultOverride=null, $ignoreHidden=false)
 Get the user's current setting for a given option.
 getOptions ()
 Get all user's options.
 getPageRenderingHash ()
 Generate a string which will be different for any combination of user options which would produce different parser output.
 getPasswordValidity ($password)
 Given unvalidated password input, return error message on failure.
 getRealName ()
 Get the user's real name.
 getRegistration ()
 Get the timestamp of account creation.
 getRequest ()
 Get the WebRequest object to use with this object.
 getRights ()
 Get the permissions this user has.
 getSkin ()
 Get the current skin, loading it if required.
 getStubThreshold ()
 Get the user preferred stub threshold.
 getTalkPage ()
 Get this user's talk page title.
 getTitleKey ()
 Get the user's name escaped by underscores.
 getToken ($forceCreation=true)
 Get the user's current token.
 getTouched ()
 Get the user touched timestamp.
 getUserPage ()
 Get this user's personal page title.
 getWatchedItem ($title)
 Get a WatchedItem for this user and $title.
 idForName ()
 If only this user's username is known, and it exists, return the user ID.
 incEditCount ()
 Increment the user's edit-count field.
 inDnsBlacklist ($ip, $bases)
 Whether the given IP is in a given DNS blacklist.
 invalidateCache ()
 Immediately touch the user data cache for this account.
 invalidateEmail ()
 Invalidate the user's e-mail confirmation, and unauthenticate the e-mail address if it was already confirmed.
 isAllowed ($action= '')
 Internal mechanics of testing a permission.
 isAllowedAll ()
 isAllowedAny ()
 Check if user is allowed to access a feature / make an action.
 isAllowedToCreateAccount ()
 Get whether the user is allowed to create an account.
 isAnon ()
 Get whether the user is anonymous.
 isBlocked ($bFromSlave=true)
 Check if user is blocked.
 isBlockedFrom ($title, $bFromSlave=false)
 Check if user is blocked from editing a particular article.
 isBlockedFromCreateAccount ()
 Get whether the user is explicitly blocked from account creation.
 isBlockedFromEmailuser ()
 Get whether the user is blocked from using Special:Emailuser.
 isBlockedGlobally ($ip= '')
 Check if user is blocked on all wikis.
 isDnsBlacklisted ($ip, $checkWhitelist=false)
 Whether the given IP is in a DNS blacklist.
 isEmailConfirmationPending ()
 Check whether there is an outstanding request for e-mail confirmation.
 isEmailConfirmed ()
 Is this user's e-mail address valid-looking and confirmed within limits of the current site configuration?
 isHidden ()
 Check if user account is hidden.
 isItemLoaded ($item, $all= 'all')
 Return whether an item has been loaded.
 isLocked ()
 Check if user account is locked.
 isLoggedIn ()
 Get whether the user is logged in.
 isNewbie ()
 Determine whether the user is a newbie.
 isPasswordReminderThrottled ()
 Has password reminder email been sent within the last $wgPasswordReminderResendTime hours?
 isPingLimitable ()
 Is this user subject to rate limiting?
 isValidPassword ($password)
 Is the input a valid password for this user?
 isWatched ($title)
 Check the watched status of an article.
 load ()
 Load the user table data for this object from the source given by mFrom.
 loadDefaults ($name=false)
 Set cached properties to default.
 loadFromDatabase ()
 Load user and user_group data from the database.
 loadFromId ()
 Load user table data, given mId has already been set.
 loadFromRow ($row, $data=null)
 Initialize this object from a row from the user table.
 logout ()
 Log this user out.
 matchEditToken ($val, $salt= '', $request=null)
 Check given value against the token value stored in the session.
 matchEditTokenNoSuffix ($val, $salt= '', $request=null)
 Check given value against the token value stored in the session, ignoring the suffix.
 pingLimiter ($action= 'edit')
 Primitive rate limits: enforce maximum actions per time period to put a brake on flooding.
 removeGroup ($group)
 Remove the user from the given group.
 removeWatch ($title)
 Stop watching an article.
 resetOptions ()
 Reset all options to the site defaults.
 saveSettings ()
 Save this user's settings into the database.
 saveToCache ()
 Save user data to the shared cache.
 sendConfirmationMail ($type= 'created')
 Generate a new e-mail confirmation token and send a confirmation/invalidation mail to the user's given address.
 sendMail ($subject, $body, $from=null, $replyto=null)
 Send an e-mail to this user's account.
 setCookies ($request=null, $secure=null)
 Set the default cookies for this session on the user's client.
 setEmail ($str)
 Set the user's e-mail address.
 setEmailAuthenticationTimestamp ($timestamp)
 Set the e-mail authentication timestamp.
 setEmailWithConfirmation ($str)
 Set the user's e-mail address and a confirmation mail if needed.
 setId ($v)
 Set the user and reload all fields according to a given ID.
 setInternalPassword ($str)
 Set the password and reset the random token unconditionally.
 setName ($str)
 Set the user name.
 setNewpassword ($str, $throttle=true)
 Set the password for a password reminder or new account email.
 setNewtalk ($val, $curRev=null)
 Update the 'You have new messages!' status.
 setOption ($oname, $val)
 Set the given option for a user.
 setPassword ($str)
 Set the password and reset the random token.
 setRealName ($str)
 Set the user's real name.
 setToken ($token=false)
 Set the random token (used for persistent authentication) Called from loadDefaults() among other places.
 spreadAnyEditBlock ()
 If this user is logged-in and blocked, block any IP address they've successfully logged in from.
 useNPPatrol ()
 Check whether to enable new pages patrol features for this user.
 useRCPatrol ()
 Check whether to enable recent changes patrol features for this user.
 validateCache ($timestamp)
 Validate the cache for this account.

Static Public Member Functions

static changeableByGroup ($group)
 Returns an array of the groups that a particular group can add/remove.
static comparePasswords ($hash, $password, $userId=false)
 Compare a password hash with a plain-text password.
static createNew ($name, $params=array())
 Add a user to the database, return the user object.
static crypt ($password, $salt=false)
 Make a new-style password hash.
static edits ($uid)
 Count the number of edits of a user.
static generateToken ($salt= '')
 Generate a looking random token for various uses.
static getAllGroups ()
 Return the set of defined explicit groups.
static getAllRights ()
 Get a list of all available permissions.
static getCanonicalName ($name, $validate= 'valid')
 Given unvalidated user input, return a canonical username, or false if the username is invalid.
static getDefaultOption ($opt)
 Get a given default option value.
static getDefaultOptions ()
 Combine the language default options with any site-specific options and add the default language variants.
static getGroupMember ($group, $username= '#')
 Get the localized descriptive name for a member of a group, if it exists.
static getGroupName ($group)
 Get the localized descriptive name for a group, if it exists.
static getGroupPage ($group)
 Get the title of a page describing a particular group.
static getGroupPermissions ($groups)
 Get the permissions associated with a given list of groups.
static getGroupsWithPermission ($role)
 Get all the groups who have a given permission.
static getImplicitGroups ()
 Get a list of implicit groups.
static getRightDescription ($right)
 Get the description of a given right.
static groupHasPermission ($group, $role)
 Check, if the given group has the given permission.
static idFromName ($name)
 Get database id given a user name.
static isCreatableName ($name)
 Usernames which fail to pass this function will be blocked from new account registrations, but may be used internally either by batch processes or by user accounts which have already been created.
static isIP ($name)
 Does the string match an anonymous IPv4 address?
static isLocallyBlockedProxy ($ip)
 Check if an IP address is in the local proxy list.
static isUsableName ($name)
 Usernames which fail to pass this function will be blocked from user login and new account registrations, but may be used internally by batch processes.
static isValidEmailAddr ($addr)
 Does a string look like an e-mail address?
static isValidUserName ($name)
 Is the input a valid username?
static makeGroupLinkHTML ($group, $text= '')
 Create a link to the group in HTML, if available; else return the group name.
static makeGroupLinkWiki ($group, $text= '')
 Create a link to the group in Wikitext, if available; else return the group name.
static oldCrypt ($password, $userId)
 Make an old-style password hash.
static passwordChangeInputAttribs ()
 Provide an array of HTML5 attributes to put on an input element intended for the user to enter a new password.
static randomPassword ()
 Return a random password.
static resetIdByNameCache ()
 Reset the cache used in idFromName().
static selectFields ()
 Return the list of user fields that should be selected to create a new user object.
static whoIs ($id)
 Get the username corresponding to a given user ID.
static whoIsReal ($id)
 Get the real name of a user given their user ID.
newFrom*() static factory methods
static newFromName ($name, $validate= 'valid')
 Static factory method for creation from username.
static newFromId ($id)
 Static factory method for creation from a given user ID.
static newFromConfirmationCode ($code)
 Factory method to fetch whichever user has a given email confirmation code.
static newFromSession (WebRequest $request=null)
 Create a new user object using data from session or cookies.
static newFromRow ($row, $data=null)
 Create a new user object from a user row.

Public Attributes

bool $mAllowUsertalk
Block $mBlock
 $mBlockedby
 $mBlockedGlobally
 $mBlockreason
 $mDatePreference
 $mEffectiveGroups
 $mFormerGroups
 $mFrom
 String Initialization data source if mLoadedItems!==true.
 $mHash
 $mHideName
 $mImplicitGroups
 $mLocked
 $mNewtalk
 Lazy-initialized variables, invalidated with clearInstanceCache.
 $mOptions
 $mRights
const EDIT_TOKEN_SUFFIX = EDIT_TOKEN_SUFFIX
const MAX_WATCHED_ITEMS_CACHE = 100
 Maximum items in $mWatchedItems.
const MW_USER_VERSION = MW_USER_VERSION
const USER_TOKEN_LENGTH = USER_TOKEN_LENGTH
 Global constants made accessible as class constants so that autoloader magic can be used.
Cache variables
 $mId
 $mName
 $mRealName
 $mPassword
 $mNewpassword
 $mNewpassTime
 $mEmail
 $mTouched
 $mToken
 $mEmailAuthenticated
 $mEmailToken
 $mEmailTokenExpires
 $mRegistration
 $mEditCount
 $mGroups
 $mOptionOverrides

Static Public Attributes

static $idCacheByName = array()
static $mAllRights = false
 String Cached results of getAllRights()
static $mCacheVars
 Array of Strings List of member variables which are saved to the shared cache (memcached).
static $mCoreRights
 Array of Strings Core rights.

Protected Member Functions

 checkNewtalk ($field, $id, $fromMaster=false)
 Internal uncached check for new messages.
 clearCookie ($name)
 Clear a cookie on the user's client.
 deleteNewtalk ($field, $id)
 Clear the new messages flag for the given user.
 getTokenUrl ($page, $token)
 Internal function to format the e-mail validation/invalidation URLs.
 initEditCount ($add=0)
 Initialize user_editcount from data out of the revision table.
 loadFromUserObject ($user)
 Load the data for this user object from another user object.
 loadOptions ($data=null)
 Load the user options either from cache, the database or an array.
 saveOptions ()
 setCookie ($name, $value, $exp=0, $secure=null)
 Set a cookie on the user's client.
 spreadBlock ()
 If this (non-anonymous) user is blocked, block the IP address they've successfully logged in from.
 updateNewtalk ($field, $id, $curRev=null)
 Add or update the new messages flag.

Private Member Functions

 clearSharedCache ()
 Clear user data from memcached.
 confirmationToken (&$expiration)
 Generate, store, and return a new e-mail confirmation code.
 confirmationTokenUrl ($token)
 Return a URL the user can use to confirm their email address.
 decodeOptions ($str)
 Set this user's options from an encoded string.
 getBlockedStatus ($bFromSlave=true)
 Get blocking information.
 invalidationTokenUrl ($token)
 Return a URL the user can use to invalidate their email address.
 loadFromSession ()
 Load user data from the session or login cookie.
 loadGroups ()
 Load the groups from the database if they aren't already loaded.
 setItemLoaded ($item)
 Set that an item has been loaded.

Static Private Member Functions

static newTouchedTimestamp ()
 Generate a current or new-future timestamp to be stored in the user_touched field when we update things.

Private Attributes

Block $mBlockedFromCreateAccount = false
WebRequest $mRequest
Array $mWatchedItems = array()
 $mOptionsLoaded
 Bool Whether the cache variables have been loaded.
 $mLoadedItems = array()
 Array with already loaded items or true if all items have been loaded.

Detailed Description

The User object encapsulates all of the user-specific settings (user_id, name, rights, password, email address, options, last login time).

Client classes use the getXXX() functions to access these fields. These functions do all the work of determining whether the user is logged in, whether the requested option can be satisfied from cookies or whether a database query is needed. Most of the settings needed for rendering normal pages are set in the cookie to minimize use of the database.

Definition at line 59 of file User.php.


Constructor & Destructor Documentation

Lightweight constructor for an anonymous user.

Use the User::newFrom* factory functions for other kinds of users.

See also:
newFromName()
newFromId()
newFromConfirmationCode()
newFromSession()
newFromRow()

Definition at line 244 of file User.php.


Member Function Documentation

Returns:
String

Definition at line 251 of file User.php.

Add the user to the group if he/she meets given criteria.

Contrary to autopromotion by $wgAutopromote, the group will be possible to remove manually via Special:UserRights. In such case it will not be re-added automatically. The user will also not lose the group if they no longer meet the criteria.

Parameters:
$eventString key in $wgAutopromoteOnce (each one has groups/criteria)
Returns:
array Array of groups the user has been promoted to.
See also:
$wgAutopromoteOnce

Definition at line 1154 of file User.php.

User::addGroup ( group)

Add the user to the given group.

This takes immediate effect.

Parameters:
$groupString Name of the group to add

Definition at line 2482 of file User.php.

User::addNewUserLogEntry ( byEmail = false,
reason = '' 
)

Add a newuser log entry for this user.

Before 1.19 the return value was always true.

Parameters:
$byEmailBoolean: account made by email?
$reasonString: user supplied reason
Returns:
int|bool True if not $wgNewUserLog; otherwise ID of log item or 0 on failure

Definition at line 4092 of file User.php.

Add an autocreate newuser log entry for this user Used by things like CentralAuth and perhaps other authplugins.

Returns:
bool

Definition at line 4126 of file User.php.

Add this existing user object to the database.

If the user already exists, a fatal status object is returned, and the user object is initialised with the data from the database.

Previously, this function generated a DB error due to a key conflict if the user already existed. Many extension callers use this function in code along the lines of:

$user = User::newFromName( $name ); if ( !$user->isLoggedIn() ) { $user->addToDatabase(); } // do something with $user...

However, this was vulnerable to a race condition (bug 16020). By initialising the user object if the user exists, we aim to support this calling sequence as far as possible.

Note that if the user exists, this function will acquire a write lock, so it is still advisable to make the call conditional on isLoggedIn(), and to commit the transaction after calling.

Exceptions:
MWException
Returns:
Status

Definition at line 3035 of file User.php.

User::addWatch ( title)

Watch an article.

Parameters:
$titleTitle of the article to look at

Definition at line 2678 of file User.php.

References $title, getWatchedItem(), and invalidateCache().

Referenced by WatchAction\doWatch().

If user is blocked, return the name of the user who placed the block.

Returns:
String name of blocker

Definition at line 1597 of file User.php.

References getBlockedStatus().

Referenced by SpecialBlock\checkUnblockSelf().

If user is blocked, return the specified reason for the block.

Returns:
String Blocking reason

Definition at line 1606 of file User.php.

References getBlockedStatus().

Is this user allowed to receive e-mails within limits of current site configuration?

Returns:
Bool

Definition at line 3564 of file User.php.

Is this user allowed to send e-mails within limits of current site configuration?

Returns:
Bool

Definition at line 3549 of file User.php.

static User::changeableByGroup ( group) [static]

Returns an array of the groups that a particular group can add/remove.

Parameters:
$groupString: the group to check for whether it can add/remove
Returns:
Array array( 'add' => array( addablegroups ), 'remove' => array( removablegroups ), 'add-self' => array( addablegroups to self), 'remove-self' => array( removable groups from self) )

Definition at line 3834 of file User.php.

Returns an array of groups that this user can add and remove.

Returns:
Array array( 'add' => array( addablegroups ), 'remove' => array( removablegroups ), 'add-self' => array( addablegroups to self), 'remove-self' => array( removable groups from self) )

Definition at line 3898 of file User.php.

User::checkNewtalk ( field,
id,
fromMaster = false 
) [protected]

Internal uncached check for new messages.

See also:
getNewtalk()
Parameters:
$fieldString 'user_ip' for anonymous users, 'user_id' otherwise
$idString|Int User's IP address for anonymous users, User ID otherwise
$fromMasterBool true to fetch from the master, false for a slave
Returns:
Bool True if the user has new messages

Definition at line 1816 of file User.php.

Referenced by getNewtalk().

User::checkPassword ( password)

Check to see if the given clear-text password is one of the accepted passwords.

Parameters:
$passwordString: user password.
Returns:
Boolean: True if the given password is correct, otherwise False.

Definition at line 3239 of file User.php.

User::checkTemporaryPassword ( plaintext)

Check if the given clear-text password matches the temporary password sent by e-mail for password reset operations.

Parameters:
$plaintextstring
Returns:
Boolean: True if matches, false otherwise

Definition at line 3284 of file User.php.

Resets all of the given user's page-change notification timestamps.

If e-notif e-mails are on, they will receive notification mails on the next change of any watched page.

Definition at line 2741 of file User.php.

User::clearCookie ( name) [protected]

Clear a cookie on the user's client.

Parameters:
$nameString Name of the cookie to clear

Definition at line 2809 of file User.php.

References setCookie().

Referenced by doLogout().

User::clearInstanceCache ( reloadFrom = false)

Clear various cached data stored in this object.

The cache of the user table data (i.e. self::$mCacheVars) is not cleared unless $reloadFrom is given.

Parameters:
$reloadFrombool|String Reload user and user_groups table data from a given source. May be "name", "id", "defaults", "session", or false for no reload.

Definition at line 1191 of file User.php.

Referenced by doLogout(), and setId().

User::clearNotification ( &$  title)

Clear the user's notification timestamp for the given title.

If e-notif e-mails are on, they will receive notification mails on the next change of the page if it's watched etc.

Parameters:
$titleTitle of the article to look at

Definition at line 2698 of file User.php.

User::clearSharedCache ( ) [private]

Clear user data from memcached.

Use after applying fun updates to the database; caller's responsibility to update user_touched if appropriate.

Called implicitly from invalidateCache() and saveSettings().

Definition at line 1929 of file User.php.

Referenced by saveSettings().

static User::comparePasswords ( hash,
password,
userId = false 
) [static]

Compare a password hash with a plain-text password.

Requires the user ID if there's a chance that the hash is an old-style hash.

Parameters:
$hashString Password hash
$passwordString Plain-text password to compare
$userIdString|bool User ID for old-style password salt
Returns:
Boolean

Definition at line 4063 of file User.php.

Referenced by ExternalUser_MediaWiki\authenticate().

User::confirmationToken ( &$  expiration) [private]

Generate, store, and return a new e-mail confirmation code.

A hash (unsalted, since it's used as a key) is stored.

Note:
Call saveSettings() after calling this function to commit this change to the database.
Parameters:
&$expiration Mixed : Accepts the expiration time
Returns:
String New token

Definition at line 3454 of file User.php.

User::confirmationTokenUrl ( token) [private]

Return a URL the user can use to confirm their email address.

Parameters:
$tokenString Accepts the email confirmation token
Returns:
String New token URL

Definition at line 3472 of file User.php.

Mark the e-mail address confirmed.

Note:
Call saveSettings() after calling this function to commit the change.
Returns:
bool

Definition at line 3512 of file User.php.

static User::createNew ( name,
params = array() 
) [static]

Add a user to the database, return the user object.

Parameters:
$nameString Username to add
$paramsArray of Strings Non-default parameters to save to the database as user_* fields:
  • password The user's password hash. Password logins will be disabled if this is omitted.
  • newpassword Hash for a temporary password that has been mailed to the user
  • email The user's email address
  • email_authenticated The email authentication timestamp
  • real_name The user's real name
  • options An associative array of non-default options
  • token Random authentication token. Do not set.
  • registration Registration timestamp. Do not set.
Returns:
User object, or null if the username already exists

Definition at line 2973 of file User.php.

Referenced by TestUser\__construct(), and UserWrapper\__construct().

static User::crypt ( password,
salt = false 
) [static]

Make a new-style password hash.

Parameters:
$passwordString Plain-text password
bool | string$saltOptional salt, may be random or the user ID.

If unspecified or false, will generate one automatically

Returns:
String Password hash

Definition at line 4035 of file User.php.

User::decodeOptions ( str) [private]

Set this user's options from an encoded string.

Parameters:
$strString Encoded options to import
Deprecated:
in 1.19 due to removal of user_options from the user table

Definition at line 2768 of file User.php.

User::deleteNewtalk ( field,
id 
) [protected]

Clear the new messages flag for the given user.

Parameters:
$fieldString 'user_ip' for anonymous users, 'user_id' otherwise
$idString|Int User's IP address for anonymous users, User ID otherwise
Returns:
Bool True if successful, false otherwise

Definition at line 1859 of file User.php.

Clear the user's cookies and session, and reset the instance cache.

See also:
logout()

Definition at line 2886 of file User.php.

References clearCookie(), clearInstanceCache(), getRequest(), setCookie(), and wfTimestampNow().

static User::edits ( uid) [static]

Count the number of edits of a user.

Parameters:
$uidInt User ID to check
Returns:
Int the user's edit count
Deprecated:
since 1.21 in favour of User::getEditCount

Definition at line 822 of file User.php.

User::editToken ( salt = '',
request = null 
)

Alias for getEditToken.

Deprecated:
since 1.19, use getEditToken instead.
Parameters:
$saltString|Array of Strings Optional function-specific data for hashing
$requestWebRequest object to use or null to use $wgRequest
Returns:
String The new edit token

Definition at line 3307 of file User.php.

static User::generateToken ( salt = '') [static]

Generate a looking random token for various uses.

Parameters:
$saltString Optional salt value
Returns:
String The new random token
Deprecated:
since 1.20; Use MWCryptRand for secure purposes or wfRandomString for pesudo-randomness

Definition at line 3351 of file User.php.

static User::getAllGroups ( ) [static]

Return the set of defined explicit groups.

The implicit groups (by default *, 'user' and 'autoconfirmed') are not included, as they are defined automatically, not in the database.

Returns:
Array of internal group names

Definition at line 3732 of file User.php.

Referenced by UsersPager\__construct(), ApiQueryAllUsers\execute(), UsersPager\getAllGroups(), ApiUserrights\getAllowedParams(), and ApiQueryAllUsers\getAllowedParams().

static User::getAllRights ( ) [static]

Get a list of all available permissions.

Returns:
Array of permission names

Definition at line 3744 of file User.php.

References $mAllRights, $mCoreRights, array(), global, and wfRunHooks().

Referenced by ApiQueryAllUsers\getAllowedParams().

User::getAutomaticGroups ( recache = false)

Get the list of implicit group memberships this user has.

This includes 'user' if logged in, '*' for all accounts, and autopromoted groups

Parameters:
$recacheBool Whether to avoid the cache
Returns:
Array of String internal group names

Definition at line 2401 of file User.php.

User::getBlock ( bFromSlave = true)

Get the block affecting the user, or null if the user is not blocked.

Parameters:
$bFromSlaveBool Whether to check the slave database instead of the master
Returns:
Block|null

Definition at line 1562 of file User.php.

User::getBlockedStatus ( bFromSlave = true) [private]

Get blocking information.

Parameters:
$bFromSlaveBool Whether to check the slave database first. To improve performance, non-critical checks are done against slaves. Check when actually saving should be done against master.

Definition at line 1263 of file User.php.

Referenced by blockedBy(), blockedFor(), getBlockId(), isBlockedFromCreateAccount(), and isBlockedFromEmailuser().

If user is blocked, return the ID for the block.

Returns:
Int Block ID

Definition at line 1615 of file User.php.

References false, and getBlockedStatus().

User::getBoolOption ( oname)

Get the user's current setting for a given option, as a boolean value.

Parameters:
$onameString The option to check
Returns:
Bool User's current value for the option
See also:
getOption()

Definition at line 2265 of file User.php.

static User::getCanonicalName ( name,
validate = 'valid' 
) [static]

Given unvalidated user input, return a canonical username, or false if the username is invalid.

Parameters:
$nameString User input
$validateString|Bool type of validation to use:
  • false No validation
  • 'valid' Valid for batch processes
  • 'usable' Valid for batch processes and login
  • 'creatable' Valid for batch processes, login and account creation
Exceptions:
MWException
Returns:
bool|string

Definition at line 767 of file User.php.

Referenced by RollbackEdits\execute(), UserrightsPage\execute(), ApiQueryUsers\execute(), UserrightsPage\fetchUser(), ApiQueryContributions\prepareUsername(), ApiQueryBlocks\prepareUsername(), and WebInstaller_Name\submit().

Get the user's preferred date format.

Returns:
String User's preferred date format

Definition at line 2316 of file User.php.

References $value, $wgLang, getOption(), and global.

static User::getDefaultOption ( opt) [static]

Get a given default option value.

Parameters:
$optString Name of option to retrieve
Returns:
String Default option value

Definition at line 1246 of file User.php.

Referenced by CoreParserFunctions\gender(), GenderCache\getDefault(), and Linker\makeImageLink().

static User::getDefaultOptions ( ) [static]

Combine the language default options with any site-specific options and add the default language variants.

Returns:
Array of String options

Definition at line 1215 of file User.php.

Referenced by userOptions\getDefaultOptionsNames(), Preferences\getPreferences(), userOptions\LISTER(), and userOptions\USAGER().

Get the user's edit count.

Returns:
Int

Definition at line 2451 of file User.php.

References $count, $dbr, array(), getId(), initEditCount(), wfGetDB(), wfProfileIn(), and wfProfileOut().

Referenced by Autopromote\checkCondition(), and LogFormatter\makeUserLink().

User::getEditToken ( salt = '',
request = null 
)

Initialize (if necessary) and return a session token value which can be used in edit forms to show that the user's login credentials aren't being hijacked with a foreign form submission.

Since:
1.19
Parameters:
$saltString|Array of Strings Optional function-specific data for hashing
$requestWebRequest object to use or null to use $wgRequest
Returns:
String The new edit token

Definition at line 3324 of file User.php.

Referenced by WatchAction\getWatchToken().

User::getEffectiveGroups ( recache = false)

Get the list of implicit group memberships this user has.

This includes all explicit groups, plus 'user' if logged in, '*' for all accounts, and autopromoted groups

Parameters:
$recacheBool Whether to avoid the cache
Returns:
Array of String internal group names

Definition at line 2378 of file User.php.

Referenced by getRights().

Get the user's e-mail address.

Returns:
String User's email address

Definition at line 2116 of file User.php.

References array(), load(), and wfRunHooks().

Referenced by Autopromote\checkCondition().

Get the timestamp of the user's e-mail authentication.

Returns:
String TS_MW timestamp

Definition at line 2126 of file User.php.

References array(), load(), and wfRunHooks().

Referenced by Autopromote\checkCondition().

Get the timestamp of the first edit.

Returns:
String|Bool Timestamp of first edit, or false for non-existent/anonymous user accounts.

Definition at line 3630 of file User.php.

Referenced by Autopromote\checkCondition().

Returns the groups the user has belonged to.

The user may still belong to the returned groups. Compare with getGroups().

The function will not return groups the user had belonged to before MW 1.17

Returns:
array Names of the groups the user has belonged to.

Definition at line 2432 of file User.php.

Referenced by Autopromote\getAutopromoteOnceGroups().

static User::getGroupMember ( group,
username = '#' 
) [static]

Get the localized descriptive name for a member of a group, if it exists.

Parameters:
$groupString Internal group name
$usernameString Username for gender (since 1.19)
Returns:
String Localized name for group member

Definition at line 3721 of file User.php.

Referenced by UsersPager\buildGroupLink(), UserrightsPage\buildGroupMemberLink(), UserrightsPage\groupCheckboxes(), and Preferences\profilePreferences().

static User::getGroupName ( group) [static]

Get the localized descriptive name for a group, if it exists.

Parameters:
$groupString Internal group name
Returns:
String Localized descriptive group name

Definition at line 3709 of file User.php.

Referenced by UserrightsPage\buildGroupLink(), UsersPager\getAllGroups(), and Preferences\profilePreferences().

static User::getGroupPage ( group) [static]

Get the title of a page describing a particular group.

Parameters:
$groupString Internal group name
Returns:
Title|Bool Title of the page if it exists, false otherwise

Definition at line 3774 of file User.php.

static User::getGroupPermissions ( groups) [static]

Get the permissions associated with a given list of groups.

Parameters:
$groupsArray of Strings List of internal group names
Returns:
Array of Strings List of permission key names for given groups combined

Definition at line 3652 of file User.php.

Referenced by Autopromote\checkCondition(), ApiQueryAllUsers\execute(), getRights(), and UserTest\testGroupPermissions().

Get the list of explicit group memberships this user has.

The implicit * and user groups are not included.

Returns:
Array of String internal group names

Definition at line 2365 of file User.php.

Referenced by Autopromote\checkCondition(), and Autopromote\getAutopromoteOnceGroups().

static User::getGroupsWithPermission ( role) [static]

Get all the groups who have a given permission.

Parameters:
$roleString Role to check
Returns:
Array of Strings List of internal group names with the given permission

Definition at line 3679 of file User.php.

Referenced by PermissionsError\__construct(), ApiQueryAllUsers\execute(), NewFilesPager\getQueryInfo(), ContribsPager\getUserCond(), Title\missingPermissionError(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), and ApiQueryAllImages\run().

Get the user's ID.

Returns:
Int The user's ID; 0 if the user is anonymous or nonexistent

Definition at line 1681 of file User.php.

References isIP(), isItemLoaded(), and load().

Referenced by SpecialBlock\checkUnblockSelf(), ApiUnblock\execute(), ApiBlock\execute(), getEditCount(), SpecialEmailUser\getTarget(), SpecialContributions\getUserLinks(), incEditCount(), and LogFormatter\makeUserLink().

static User::getImplicitGroups ( ) [static]

Get a list of implicit groups.

Returns:
Array of Strings Array of internal group names

Definition at line 3761 of file User.php.

References array(), global, use, and wfRunHooks().

Referenced by UsersPager\getGroups().

User::getIntOption ( oname,
defaultOverride = 0 
)

Get the user's current setting for a given option, as a boolean value.

Parameters:
$onameString The option to check
$defaultOverrideInt A default value returned if the option does not exist
Returns:
Int User's current value for the option
See also:
getOption()

Definition at line 2277 of file User.php.

Return the talk page(s) this user has new messages on.

Returns:
Array of String page URLs

Definition at line 1789 of file User.php.

References $dbr, $timestamp, array(), getName(), getNewtalk(), getTalkPage(), isAnon(), Revision\loadFromTimestamp(), wfGetDB(), wfRunHooks(), and wfWikiID().

Check if the user has new messages.

Returns:
Bool True if the user has new messages

Definition at line 1750 of file User.php.

References $wgMemc, checkNewtalk(), getName(), global, load(), page, and wfMemcKey().

Referenced by getNewMessageLinks().

User::getOption ( oname,
defaultOverride = null,
ignoreHidden = false 
)

Get the user's current setting for a given option.

Parameters:
$onameString The option to check
$defaultOverrideString A default value returned if the option does not exist
$ignoreHiddenBool = whether to ignore the effects of $wgHiddenPrefs
Returns:
String User's current value for the option
See also:
getBoolOption()
getIntOption()

Reimplemented in PPFuzzUser.

Definition at line 2213 of file User.php.

Referenced by getDatePreference().

Get all user's options.

Returns:
array

Definition at line 2238 of file User.php.

Generate a string which will be different for any combination of user options which would produce different parser output.

This will be used as part of the hash key for the parser cache, so users with the same options can share the same cached data safely.

Extensions which require it should install 'PageRenderingHash' hook, which will give them a chance to modify this key based on their own settings.

Deprecated:
since 1.17 use the ParserOptions object to get the relevant options
Returns:
String Page rendering hash

Definition at line 3129 of file User.php.

User::getPasswordValidity ( password)

Given unvalidated password input, return error message on failure.

Parameters:
$passwordString Desired password
Returns:
mixed: true on success, string or array of error message on failure

Definition at line 688 of file User.php.

Get the user's real name.

Returns:
String User's real name

Definition at line 2186 of file User.php.

References isItemLoaded(), and load().

Referenced by CreditsAction\link(), RdfMetaData\person(), and CreditsAction\userLink().

Get the timestamp of account creation.

Returns:
String|Bool Timestamp of account creation, or false for non-existent/anonymous user accounts.

Definition at line 3616 of file User.php.

Referenced by Autopromote\checkCondition().

Get the WebRequest object to use with this object.

Returns:
WebRequest

Definition at line 2624 of file User.php.

Referenced by Autopromote\checkCondition(), doLogout(), getName(), isBlockedFromCreateAccount(), and loadFromSession().

static User::getRightDescription ( right) [static]

Get the description of a given right.

Parameters:
$rightString Right to query
Returns:
String Localized description of the right

Definition at line 4004 of file User.php.

Referenced by SpecialListGroupRights\formatPermissions().

Get the permissions this user has.

Returns:
Array of String permission names

Definition at line 2350 of file User.php.

References array(), getEffectiveGroups(), getGroupPermissions(), and wfRunHooks().

Get the current skin, loading it if required.

Returns:
Skin The current skin
Todo:
FIXME: Need to check the old failback system [AV]
Deprecated:
since 1.18 Use ->getSkin() in the most relevant outputting context you have

Definition at line 2639 of file User.php.

Get the user preferred stub threshold.

Returns:
int

Definition at line 2335 of file User.php.

Get this user's talk page title.

Returns:
Title: User's talk page title

Definition at line 3220 of file User.php.

Referenced by getNewMessageLinks().

Get the user's name escaped by underscores.

Returns:
String Username escaped by underscores.

Definition at line 1742 of file User.php.

References getName().

User::getToken ( forceCreation = true)

Get the user's current token.

Parameters:
$forceCreationForce the generation of a new token if the user doesn't have one (default=true for backwards compatibility)
Returns:
String Token

Definition at line 2060 of file User.php.

User::getTokenUrl ( page,
token 
) [protected]

Internal function to format the e-mail validation/invalidation URLs.

This uses a quickie hack to use the hardcoded English names of the Special: pages, for ASCII safety.

Note:
Since these URLs get dropped directly into emails, using the short English names avoids insanely long URL-encoded links, which also sometimes can get corrupted in some browsers/mailers (bug 6957 with Gmail and Internet Explorer).
Parameters:
$pageString Special page
$tokenString Token
Returns:
String Formatted URL

Definition at line 3499 of file User.php.

Get the user touched timestamp.

Returns:
String timestamp

Definition at line 1984 of file User.php.

References load().

Get this user's personal page title.

Returns:
Title: User's personal page title

Definition at line 3211 of file User.php.

Referenced by CreditsAction\link(), RdfMetaData\person(), and saveSettings().

User::getWatchedItem ( title)

Get a WatchedItem for this user and $title.

Parameters:
$titleTitle
Returns:
WatchedItem

Definition at line 2650 of file User.php.

Referenced by addWatch(), and removeWatch().

static User::groupHasPermission ( group,
role 
) [static]

Check, if the given group has the given permission.

Parameters:
$groupString Group to check
$roleString Role to check
Returns:
bool

Definition at line 3697 of file User.php.

Referenced by ProtectionForm\buildCleanupScript(), Title\checkQuickPermissions(), Title\checkReadPermissions(), SpecialNewpages\filterLinks(), RawAction\onView(), and ProtectionForm\save().

If only this user's username is known, and it exists, return the user ID.

Returns:
Int

Definition at line 2945 of file User.php.

References $dbr, array(), getName(), and wfGetDB().

static User::idFromName ( name) [static]

Get database id given a user name.

Parameters:
$nameString Username
Returns:
Int|Null The corresponding user's ID, or null if user is nonexistent

Definition at line 488 of file User.php.

Referenced by LegacyTemplate\bottomLinks(), ApiQueryLogEvents\execute(), UsersPager\getQueryInfo(), ContribsPager\getUserCond(), LogPager\limitPerformer(), SpecialUnblock\processUnblock(), StandardTemplate\quickBar(), and BlockTest\testBug29116LoadWithEmptyIp().

Increment the user's edit-count field.

Will have no effect for anonymous users.

Definition at line 3938 of file User.php.

References $dbr, array(), getId(), initEditCount(), invalidateCache(), isAnon(), and wfGetDB().

User::inDnsBlacklist ( ip,
bases 
)

Whether the given IP is in a given DNS blacklist.

Parameters:
$ipString IP to check
$basesString|Array of Strings: URL of the DNS blacklist
Returns:
Bool True if blacklisted.

Definition at line 1357 of file User.php.

User::initEditCount ( add = 0) [protected]

Initialize user_editcount from data out of the revision table.

Parameters:
$addInteger Edits to add to the count from the revision table
Returns:
Integer Number of edits

Definition at line 3975 of file User.php.

Referenced by getEditCount(), and incEditCount().

Immediately touch the user data cache for this account.

Updates user_touched field, and removes account data from memcached for reload on the next hit.

Definition at line 1942 of file User.php.

Referenced by addWatch(), incEditCount(), and removeWatch().

Invalidate the user's e-mail confirmation, and unauthenticate the e-mail address if it was already confirmed.

Note:
Call saveSettings() after calling this function to commit the change.
Returns:
bool Returns true

Definition at line 3525 of file User.php.

Referenced by setEmail().

User::invalidationTokenUrl ( token) [private]

Return a URL the user can use to invalidate their email address.

Parameters:
$tokenString Accepts the email confirmation token
Returns:
String New token URL

Definition at line 3481 of file User.php.

User::isAllowed ( action = '')

Internal mechanics of testing a permission.

Parameters:
$actionString
Returns:
bool

Definition at line 2586 of file User.php.

Referenced by SpecialBlock\checkUnblockSelf(), isAllowedToCreateAccount(), and Title\isNamespaceProtected().

Definition at line 2571 of file User.php.

Check if user is allowed to access a feature / make an action.

Definition at line 2556 of file User.php.

Referenced by useNPPatrol(), and useRCPatrol().

Get whether the user is allowed to create an account.

Returns:
Bool

Definition at line 3202 of file User.php.

References isAllowed(), and isBlockedFromCreateAccount().

Get whether the user is anonymous.

Returns:
Bool

Definition at line 2544 of file User.php.

References isLoggedIn().

Referenced by WatchAction\checkCanExecute(), getNewMessageLinks(), incEditCount(), CreditsAction\link(), RdfMetaData\person(), and CreditsAction\userLink().

User::isBlocked ( bFromSlave = true)

Check if user is blocked.

Parameters:
$bFromSlaveBool Whether to check the slave database instead of the master
Returns:
Bool True if blocked, false otherwise

Definition at line 1552 of file User.php.

Referenced by Autopromote\checkCondition(), SpecialBlock\checkUnblockSelf(), and SpecialContributions\getUserLinks().

User::isBlockedFrom ( title,
bFromSlave = false 
)

Check if user is blocked from editing a particular article.

Parameters:
$titleTitle to check
$bFromSlaveBool whether to check the slave database instead of the master
Returns:
Bool

Definition at line 1574 of file User.php.

Get whether the user is explicitly blocked from account creation.

Returns:
Bool|Block

Definition at line 3172 of file User.php.

References getBlockedStatus(), getRequest(), and Block\newFromTarget().

Referenced by isAllowedToCreateAccount().

Get whether the user is blocked from using Special:Emailuser.

Returns:
Bool

Definition at line 3193 of file User.php.

References getBlockedStatus().

User::isBlockedGlobally ( ip = '')

Check if user is blocked on all wikis.

Do not use for actual edit permission checks! This is intented for quick UI checks.

Parameters:
$ipString IP address, uses current client if none given
Returns:
Bool True if blocked, false otherwise

Definition at line 1628 of file User.php.

static User::isCreatableName ( name) [static]

Usernames which fail to pass this function will be blocked from new account registrations, but may be used internally either by batch processes or by user accounts which have already been created.

Additional blacklisting may be added here rather than in isValidUserName() to avoid disrupting existing accounts.

Parameters:
$nameString to match
Returns:
Bool

Definition at line 647 of file User.php.

User::isDnsBlacklisted ( ip,
checkWhitelist = false 
)

Whether the given IP is in a DNS blacklist.

Parameters:
$ipString IP to check
$checkWhitelistBool: whether to check the whitelist first
Returns:
Bool True if blacklisted.

Definition at line 1336 of file User.php.

Check whether there is an outstanding request for e-mail confirmation.

Returns:
Bool

Definition at line 3602 of file User.php.

References global, isEmailConfirmed(), and wfTimestamp().

Is this user's e-mail address valid-looking and confirmed within limits of the current site configuration?

Note:
If $wgEmailAuthentication is on, this may require the user to have confirmed their address by returning a code or using a password sent to the address from the wiki.
Returns:
Bool

Definition at line 3578 of file User.php.

Referenced by isEmailConfirmationPending().

Check if user account is hidden.

Returns:
Bool True if hidden, false otherwise

Definition at line 1664 of file User.php.

static User::isIP ( name) [static]

Does the string match an anonymous IPv4 address?

This function exists for username validation, in order to reject usernames which are similar in form to IP addresses. Strings such as 300.300.300.300 will return true because it looks like an IP address, despite not being strictly valid.

We match "\d{1,3}\.\d{1,3}\.\d{1,3}\.xxx" as an anonymous IP address because the usemod software would "cloak" anonymous IP addresses like this, if we allowed accounts like this to be created new users could get the old edits of these anonymous users.

Parameters:
$nameString to match
Returns:
Bool

Definition at line 540 of file User.php.

Referenced by LegacyTemplate\bottomLinks(), RollbackEdits\execute(), getId(), Skin\getRelevantUser(), ReassignEdits\initialiseUser(), ApiQueryContributions\prepareUsername(), ApiQueryBlocks\prepareUsername(), and StandardTemplate\quickBar().

User::isItemLoaded ( item,
all = 'all' 
)

Return whether an item has been loaded.

Parameters:
$itemString: item to check. Current possibilities:
  • id
  • name
  • realname
$allString: 'all' to check if the whole object has been loaded or any other string to check if only the item is available (e.g. for optimisation)
Returns:
Boolean

Definition at line 896 of file User.php.

Referenced by getId(), getName(), and getRealName().

static User::isLocallyBlockedProxy ( ip) [static]

Check if an IP address is in the local proxy list.

Parameters:
$ipstring
Returns:
bool

Definition at line 1404 of file User.php.

Check if user account is locked.

Returns:
Bool True if locked, false otherwise

Definition at line 1649 of file User.php.

Get whether the user is logged in.

Returns:
Bool

Definition at line 2536 of file User.php.

Referenced by isAnon().

Determine whether the user is a newbie.

Newbies are either anonymous IPs, or the most recently created accounts.

Returns:
Bool

Definition at line 3230 of file User.php.

Has password reminder email been sent within the last $wgPasswordReminderResendTime hours?

Returns:
Bool

Definition at line 2102 of file User.php.

Is this user subject to rate limiting?

Returns:
Bool True if rate limited

Definition at line 1436 of file User.php.

static User::isUsableName ( name) [static]

Usernames which fail to pass this function will be blocked from user login and new account registrations, but may be used internally by batch processes.

If an account already exists in this form, login will be blocked by a failure to pass this function.

Parameters:
$nameString to match
Returns:
Bool

Definition at line 610 of file User.php.

static User::isValidEmailAddr ( addr) [static]

Does a string look like an e-mail address?

This validates an email address using an HTML5 specification found at: http://www.whatwg.org/specs/web-apps/current-work/multipage/states-of-the-type-attribute.html#valid-e-mail-address Which as of 2011-01-24 says:

A valid e-mail address is a string that matches the ABNF production 1*( atext / "." ) "@" ldh-str *( "." ldh-str ) where atext is defined in RFC 5322 section 3.2.3, and ldh-str is defined in RFC 1034 section 3.5.

This function is an implementation of the specification as requested in bug 22449.

Client-side forms will use the same standard validation rules via JS or HTML 5 validation; additional restrictions can be enforced server-side by extensions via the 'isValidEmailAddr' hook.

Note that this validation doesn't 100% match RFC 2822, but is believed to be liberal enough for wide use. Some invalid addresses will still pass validation here.

Parameters:
$addrString E-mail address
Returns:
Bool
Deprecated:
since 1.18 call Sanitizer::isValidEmail() directly

Definition at line 749 of file User.php.

User::isValidPassword ( password)

Is the input a valid password for this user?

Parameters:
$passwordString Desired password
Returns:
Bool

Definition at line 677 of file User.php.

static User::isValidUserName ( name) [static]

Is the input a valid username?

Checks if the input is a valid username, we don't want an empty string, an IP address, anything that containins slashes (would mess up subpages), is longer than the maximum allowed username size or doesn't begin with a capital letter.

Parameters:
$nameString to match
Returns:
Bool

Definition at line 555 of file User.php.

Referenced by GenderCache\doQuery(), and CheckUsernames\execute().

User::isWatched ( title)

Check the watched status of an article.

Parameters:
$titleTitle of the article to look at
Returns:
Bool

Definition at line 2670 of file User.php.

Load the user table data for this object from the source given by mFrom.

Reimplemented in PPFuzzUser.

Definition at line 258 of file User.php.

Referenced by getEmail(), getEmailAuthenticationTimestamp(), getId(), getName(), getNewtalk(), getRealName(), getTouched(), saveSettings(), setEmail(), setEmailAuthenticationTimestamp(), and setRealName().

User::loadDefaults ( name = false)

Set cached properties to default.

Note:
This no longer clears uncached lazy-initialised properties; the constructor does that instead.
Parameters:
$namestring

Definition at line 853 of file User.php.

Referenced by PPFuzzUser\load(), and loadFromId().

Load user and user_group data from the database.

$this->mId must be set, this is how the user is identified.

Returns:
Bool True if the user exists, false if the user is anonymous

Definition at line 1002 of file User.php.

Referenced by loadFromId().

Load user table data, given mId has already been set.

Returns:
Bool false if the ID does not exist, true otherwise

Definition at line 300 of file User.php.

References $name, $wgMemc, as, global, loadDefaults(), loadFromDatabase(), saveToCache(), wfDebug(), and wfMemcKey().

User::loadFromRow ( row,
data = null 
)

Initialize this object from a row from the user table.

Parameters:
$rowArray Row from the user table to load.
$dataArray Further user data to load into the object

user_groups Array with groups out of the user_groups table user_properties Array with properties out of the user_properties table

Definition at line 1040 of file User.php.

User::loadFromSession ( ) [private]

Load user data from the session or login cookie.

Returns:
Bool True if the user is logged in, false otherwise.

Definition at line 916 of file User.php.

References $result, array(), getRequest(), global, loadFromUserObject(), ExternalUser\newFromCookie(), newFromId(), wfDebug(), wfDebugLog(), and wfRunHooks().

User::loadFromUserObject ( user) [protected]

Load the data for this user object from another user object.

Parameters:
$userUser

Definition at line 1114 of file User.php.

Referenced by loadFromSession().

User::loadGroups ( ) [private]

Load the groups from the database if they aren't already loaded.

Definition at line 1126 of file User.php.

User::loadOptions ( data = null) [protected]

Load the user options either from cache, the database or an array.

Parameters:
$dataRows for the current user out of the user_properties table

Definition at line 4141 of file User.php.

Log this user out.

Definition at line 2876 of file User.php.

static User::makeGroupLinkHTML ( group,
text = '' 
) [static]

Create a link to the group in HTML, if available; else return the group name.

Parameters:
$groupString Internal name of the group
$textString The text of the link
Returns:
String HTML link to the group

Definition at line 3792 of file User.php.

Referenced by Preferences\profilePreferences().

static User::makeGroupLinkWiki ( group,
text = '' 
) [static]

Create a link to the group in Wikitext, if available; else return the group name.

Parameters:
$groupString Internal name of the group
$textString The text of the link
Returns:
String Wikilink to the group

Definition at line 3812 of file User.php.

User::matchEditToken ( val,
salt = '',
request = null 
)

Check given value against the token value stored in the session.

A match should confirm that the form was submitted from the user's own login session, not a form submission from a third-party site.

Parameters:
$valString Input value to compare
$saltString Optional function-specific data for hashing
$requestWebRequest object to use or null to use $wgRequest
Returns:
Boolean: Whether the token matches

Definition at line 3366 of file User.php.

User::matchEditTokenNoSuffix ( val,
salt = '',
request = null 
)

Check given value against the token value stored in the session, ignoring the suffix.

Parameters:
$valString Input value to compare
$saltString Optional function-specific data for hashing
$requestWebRequest object to use or null to use $wgRequest
Returns:
Boolean: Whether the token matches

Definition at line 3383 of file User.php.

static User::newFromConfirmationCode ( code) [static]

Factory method to fetch whichever user has a given email confirmation code.

This code is generated when an account is created or its e-mail address has changed.

If the code is invalid or has expired, returns NULL.

Parameters:
$codeString Confirmation code
Returns:
User object, or null

Definition at line 414 of file User.php.

Referenced by EmailConfirmation\attemptConfirm(), and EmailInvalidation\attemptInvalidate().

static User::newFromName ( name,
validate = 'valid' 
) [static]

Static factory method for creation from username.

This is slightly less efficient than newFromId(), so use newFromId() if you have both an ID and a name handy.

Parameters:
$nameString Username, validated by Title::newFromText()
$validateString|Bool Validate username. Takes the same parameters as User::getCanonicalName(), except that true is accepted as an alias for 'valid', for BC.
Returns:
User|bool User object, or false if the username is invalid (e.g. if it contains illegal characters or is an IP address). If the username is not present in the database, the result will be a user object with a name, zero user ID and default settings.

Definition at line 373 of file User.php.

Referenced by TestUser\__construct(), RecentChangeTest\__construct(), UserWrapper\__construct(), GenderCacheTest\addDBData(), ApiBlockTest\addDBData(), BlockTest\addDBData(), BackupDumperLoggerTest\addDBData(), EditPageTest\assertEdit(), SpecialChangePassword\attemptReset(), SpecialBlock\checkUnblockSelf(), Undelete\execute(), SpecialBlockme\execute(), SpecialContributions\execute(), DeleteDefaultMessages\execute(), CleanupSpam\execute(), ImportSiteScripts\execute(), RollbackEdits\execute(), ChangePassword\execute(), CreateAndPromote\execute(), Protect\execute(), EditCLI\execute(), CapsCleanup\execute(), SpecialLog\execute(), TableCleanup\execute(), DeleteBatch\execute(), MoveBatch\execute(), DeletedContributionsPage\execute(), UserrightsPage\fetchUser(), CoreParserFunctions\gender(), CreditsAction\getAuthor(), ResourceLoaderUserGroupsModule\getPages(), DatabaseLogEntry\getPerformer(), RCDatabaseLogEntry\getPerformer(), Skin\getRelevantUser(), SpecialEmailUser\getTarget(), DoubleRedirectJob\getUser(), ApiBase\getWatchlistUser(), ReassignEdits\initialiseUser(), SearchEngineTest\insertPage(), Block\parseTarget(), EnotifNotifyJob\run(), SpecialLog\show(), WebInstaller_Name\submit(), BlockTest\testBlockedUserCanNotCreateAccount(), BlockTest\testCrappyCrossWikiBlocks(), ApiBlockTest\testMakeNormalBlock(), and GenderCacheTest\testUserObjects().

static User::newFromRow ( row,
data = null 
) [static]

Create a new user object from a user row.

The row should have the following fields from the user table in it:

  • either user_name or user_id to load further data if needed (or both)
  • user_real_name
  • all other fields (email, password, etc.) It is useless to provide the remaining fields if either user_id, user_name and user_real_name are not provided because the whole row will be loaded once more from the database when accessing them.
Parameters:
$rowArray A row from the user table
$dataArray Further data to load into the object (see User::loadFromRow for valid keys)
Returns:
User

Definition at line 456 of file User.php.

Referenced by ConvertUserOptions\convertOptionBatch(), and ApiQueryUsers\execute().

static User::newFromSession ( WebRequest request = null) [static]

Create a new user object using data from session or cookies.

If the login credentials are invalid, the result is an anonymous user.

Parameters:
$requestWebRequest object to use; $wgRequest will be used if ommited.
Returns:
User object

Definition at line 435 of file User.php.

static User::newTouchedTimestamp ( ) [static, private]

Generate a current or new-future timestamp to be stored in the user_touched field when we update things.

Returns:
String Timestamp in TS_MW format

Definition at line 1917 of file User.php.

Referenced by saveSettings().

static User::oldCrypt ( password,
userId 
) [static]

Make an old-style password hash.

Parameters:
$passwordString Plain-text password
$userIdString User ID
Returns:
String Password hash

Definition at line 4017 of file User.php.

static User::passwordChangeInputAttribs ( ) [static]

Provide an array of HTML5 attributes to put on an input element intended for the user to enter a new password.

This may include required, title, and/or pattern, depending on $wgMinimalPasswordLength.

Do *not* use this when asking the user to enter his current password! Regardless of configuration, users may have invalid passwords for whatever reason (e.g., they were set before requirements were tightened up). Only use it when asking for a new password, like on account creation or ResetPass.

Obviously, you still need to do server-side checking.

NOTE: A combination of bugs in various browsers means that this function actually just returns array() unconditionally at the moment. May as well keep it around for when the browser bugs get fixed, though.

Todo:
FIXME: This does not belong here; put it in Html or Linker or somewhere
Returns:
array Array of HTML attributes suitable for feeding to Html::element(), directly or indirectly. (Don't feed to Xml::*()! That will potentially output invalid XHTML 1.0 Transitional, and will get confused by the boolean attribute syntax used.)

Definition at line 4273 of file User.php.

Referenced by UsercreateTemplate\execute(), and SpecialChangePassword\pretty().

User::pingLimiter ( action = 'edit')

Primitive rate limits: enforce maximum actions per time period to put a brake on flooding.

Note:
When using a shared cache like memcached, IP-address last-hit counters will be shared across wikis.
Parameters:
$actionString Action to enforce; 'edit' if unspecified
Returns:
Bool True if a rate limiter was tripped

Definition at line 1457 of file User.php.

static User::randomPassword ( ) [static]

Return a random password.

Returns:
String new random password

Definition at line 833 of file User.php.

Referenced by TestUser\__construct().

User::removeGroup ( group)

Remove the user from the given group.

This takes immediate effect.

Parameters:
$groupString Name of the group to remove

Definition at line 2507 of file User.php.

User::removeWatch ( title)

Stop watching an article.

Parameters:
$titleTitle of the article to look at

Definition at line 2687 of file User.php.

References $title, getWatchedItem(), and invalidateCache().

Referenced by WatchAction\doUnwatch().

static User::resetIdByNameCache ( ) [static]

Reset the cache used in idFromName().

For use in tests.

Definition at line 520 of file User.php.

Reset all options to the site defaults.

Definition at line 2305 of file User.php.

User::saveOptions ( ) [protected]
Todo:
document

Definition at line 4203 of file User.php.

Referenced by saveSettings().

Save this user's settings into the database.

Todo:
Only rarely do all these fields need to be set!

Definition at line 2903 of file User.php.

References array(), clearSharedCache(), getUserPage(), global, load(), newTouchedTimestamp(), saveOptions(), wfGetDB(), wfReadOnly(), and wfRunHooks().

Save user data to the shared cache.

Definition at line 336 of file User.php.

Referenced by loadFromId().

static User::selectFields ( ) [static]

Return the list of user fields that should be selected to create a new user object.

Returns:
array

Definition at line 4313 of file User.php.

Referenced by ApiQueryUsers\execute().

User::sendConfirmationMail ( type = 'created')

Generate a new e-mail confirmation token and send a confirmation/invalidation mail to the user's given address.

Parameters:
$typeString: message to send, either "created", "changed" or "set"
Returns:
Status object

Definition at line 3395 of file User.php.

User::sendMail ( subject,
body,
from = null,
replyto = null 
)

Send an e-mail to this user's account.

Does not check for confirmed status or validity.

Parameters:
$subjectString Message subject
$bodyString Message body
$fromString Optional From address; if unspecified, default $wgPasswordSender will be used
$replytoString Reply-To address
Returns:
Status

Definition at line 3432 of file User.php.

User::setCookie ( name,
value,
exp = 0,
secure = null 
) [protected]

Set a cookie on the user's client.

Wrapper for WebResponse::setCookie

Parameters:
$nameString Name of the cookie to set
$valueString Value to set
$expInt Expiration time, as a UNIX time value; if 0 or not specified, use the default $wgCookieExpiration
$secureBool true: Force setting the secure attribute when setting the cookie false: Force NOT setting the secure attribute when setting the cookie null (default): Use the default ($wgCookieSecure) to set the secure attribute

Definition at line 2801 of file User.php.

Referenced by clearCookie(), and doLogout().

User::setCookies ( request = null,
secure = null 
)

Set the default cookies for this session on the user's client.

Parameters:
$requestWebRequest object to use; $wgRequest will be used if null is passed.
$secureWhether to force secure/insecure cookies or use default

Definition at line 2820 of file User.php.

User::setEmail ( str)

Set the user's e-mail address.

Parameters:
$strString New e-mail address

Definition at line 2136 of file User.php.

References array(), invalidateEmail(), load(), and wfRunHooks().

Set the e-mail authentication timestamp.

Parameters:
$timestampString TS_MW timestamp

Definition at line 3538 of file User.php.

References $timestamp, array(), load(), and wfRunHooks().

Set the user's e-mail address and a confirmation mail if needed.

Since:
1.20
Parameters:
$strString New e-mail address
Returns:
Status

Definition at line 2153 of file User.php.

Referenced by Preferences\trySetUserEmail().

User::setId ( v)

Set the user and reload all fields according to a given ID.

Parameters:
$vInt User ID to reload

Definition at line 1697 of file User.php.

References clearInstanceCache().

Set the password and reset the random token unconditionally.

Parameters:
$strString New password to set

Definition at line 2041 of file User.php.

User::setItemLoaded ( item) [private]

Set that an item has been loaded.

Parameters:
$itemString

Definition at line 906 of file User.php.

User::setName ( str)

Set the user name.

This does not reload fields from the database according to the given name. Rather, it is used to create a temporary "nonexistent user" for later addition to the database. It can also be used to set the IP address for an anonymous user to something other than the current remote IP.

Note:
User::newFromName() has rougly the same function, when the named user does not exist.
Parameters:
$strString New user name to set

Definition at line 1733 of file User.php.

User::setNewpassword ( str,
throttle = true 
)

Set the password for a password reminder or new account email.

Parameters:
$strString New password to set
$throttleBool If true, reset the throttle timestamp to the present

Definition at line 2089 of file User.php.

User::setNewtalk ( val,
curRev = null 
)

Update the 'You have new messages!' status.

Parameters:
$valBool Whether the user has new messages
$curRevRevision new, as yet unseen revision of the user talk page. Ignored if null or !$val.

Definition at line 1878 of file User.php.

User::setOption ( oname,
val 
)

Set the given option for a user.

Parameters:
$onameString The option to set
$valmixed New value to set

Definition at line 2291 of file User.php.

User::setPassword ( str)

Set the password and reset the random token.

Calls through to authentication plugin if necessary; will have no effect if the auth plugin refuses to pass the change through or if the legal password checks fail.

As a special case, setting the password to null wipes it, so the account cannot be logged in until a new password is set, for instance via e-mail.

Parameters:
$strString New password to set
Exceptions:
PasswordErroron failure
Returns:
bool

Definition at line 2005 of file User.php.

User::setRealName ( str)

Set the user's real name.

Parameters:
$strString New real name

Definition at line 2198 of file User.php.

References load().

User::setToken ( token = false)

Set the random token (used for persistent authentication) Called from loadDefaults() among other places.

Parameters:
$tokenString|bool If specified, set the token to this value

Definition at line 2074 of file User.php.

If this user is logged-in and blocked, block any IP address they've successfully logged in from.

Returns:
bool A block was spread

Definition at line 3088 of file User.php.

User::spreadBlock ( ) [protected]

If this (non-anonymous) user is blocked, block the IP address they've successfully logged in from.

Returns:
bool A block was spread

Definition at line 3100 of file User.php.

User::updateNewtalk ( field,
id,
curRev = null 
) [protected]

Add or update the new messages flag.

Parameters:
$fieldString 'user_ip' for anonymous users, 'user_id' otherwise
$idString|Int User's IP address for anonymous users, User ID otherwise
$curRevRevision new, as yet unseen revision of the user talk page. Ignored if null.
Returns:
Bool True if successful, false otherwise

Definition at line 1834 of file User.php.

Check whether to enable new pages patrol features for this user.

Returns:
Bool True or false

Definition at line 2614 of file User.php.

References global, and isAllowedAny().

Check whether to enable recent changes patrol features for this user.

Returns:
Boolean: True or false

Definition at line 2605 of file User.php.

References global, and isAllowedAny().

User::validateCache ( timestamp)

Validate the cache for this account.

Parameters:
$timestampString A timestamp in TS_MW format
Returns:
bool

Definition at line 1975 of file User.php.

static User::whoIs ( id) [static]

Get the username corresponding to a given user ID.

Parameters:
$idInt User ID
Returns:
String|bool The corresponding username

Definition at line 469 of file User.php.

Referenced by Title\checkActionPermissions(), Title\checkUserBlock(), UserrightsPage\fetchUser(), ImageListPager\formatValue(), Block\load(), and Block\newFromDB().

static User::whoIsReal ( id) [static]

Get the real name of a user given their user ID.

Parameters:
$idInt User ID
Returns:
String|bool The corresponding user's real name

Definition at line 479 of file User.php.


Member Data Documentation

User::$idCacheByName = array() [static]

Definition at line 232 of file User.php.

bool User::$mAllowUsertalk

Definition at line 222 of file User.php.

User::$mAllRights = false [static]

String Cached results of getAllRights()

Definition at line 172 of file User.php.

Referenced by getAllRights().

Block User::$mBlock

Definition at line 218 of file User.php.

User::$mBlockedby

Definition at line 208 of file User.php.

Block User::$mBlockedFromCreateAccount = false [private]

Definition at line 226 of file User.php.

User::$mBlockedGlobally

Definition at line 208 of file User.php.

User::$mBlockreason

Definition at line 208 of file User.php.

User::$mCacheVars [static]
Initial value:
 array(
                
                'mId',
                'mName',
                'mRealName',
                'mPassword',
                'mNewpassword',
                'mNewpassTime',
                'mEmail',
                'mTouched',
                'mToken',
                'mEmailAuthenticated',
                'mEmailToken',
                'mEmailTokenExpires',
                'mRegistration',
                'mEditCount',
                
                'mGroups',
                
                'mOptionOverrides',
        )

Array of Strings List of member variables which are saved to the shared cache (memcached).

Any operation which changes the corresponding database fields must call a cache-clearing function.

Definition at line 79 of file User.php.

User::$mCoreRights [static]
Initial value:
 array(
                'apihighlimits',
                'autoconfirmed',
                'autopatrol',
                'bigdelete',
                'block',
                'blockemail',
                'bot',
                'browsearchive',
                'createaccount',
                'createpage',
                'createtalk',
                'delete',
                'deletedhistory',
                'deletedtext',
                'deletelogentry',
                'deleterevision',
                'edit',
                'editinterface',
                'editprotected',
                'editusercssjs', #deprecated
                'editusercss',
                'edituserjs',
                'hideuser',
                'import',
                'importupload',
                'ipblock-exempt',
                'markbotedits',
                'mergehistory',
                'minoredit',
                'move',
                'movefile',
                'move-rootuserpages',
                'move-subpages',
                'nominornewtalk',
                'noratelimit',
                'override-export-depth',
                'passwordreset',
                'patrol',
                'patrolmarks',
                'protect',
                'proxyunbannable',
                'purge',
                'read',
                'reupload',
                'reupload-own',
                'reupload-shared',
                'rollback',
                'sendemail',
                'siteadmin',
                'suppressionlog',
                'suppressredirect',
                'suppressrevision',
                'unblockself',
                'undelete',
                'unwatchedpages',
                'upload',
                'upload_by_url',
                'userrights',
                'userrights-interwiki',
                'writeapi',
        )

Array of Strings Core rights.

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

Definition at line 107 of file User.php.

Referenced by getAllRights().

User::$mDatePreference

Definition at line 208 of file User.php.

User::$mEditCount

Definition at line 176 of file User.php.

User::$mEffectiveGroups

Definition at line 208 of file User.php.

User::$mEmail

Definition at line 176 of file User.php.

User::$mEmailAuthenticated

Definition at line 176 of file User.php.

User::$mEmailToken

Definition at line 176 of file User.php.

User::$mEmailTokenExpires

Definition at line 176 of file User.php.

User::$mFormerGroups

Definition at line 208 of file User.php.

User::$mFrom

String Initialization data source if mLoadedItems!==true.

May be one of:

  • 'defaults' anonymous user initialised from class defaults
  • 'name' initialise from mName
  • 'id' initialise from mId
  • 'session' log in from cookies or session if possible

Use the User::newFrom*() family of functions to set this.

Definition at line 203 of file User.php.

User::$mGroups

Definition at line 176 of file User.php.

User::$mHash

Definition at line 208 of file User.php.

User::$mHideName

Definition at line 208 of file User.php.

User::$mId

Definition at line 176 of file User.php.

User::$mImplicitGroups

Definition at line 208 of file User.php.

User::$mLoadedItems = array() [private]

Array with already loaded items or true if all items have been loaded.

Definition at line 191 of file User.php.

User::$mLocked

Definition at line 208 of file User.php.

User::$mName

Definition at line 176 of file User.php.

User::$mNewpassTime

Definition at line 176 of file User.php.

User::$mNewpassword

Definition at line 176 of file User.php.

User::$mNewtalk

Lazy-initialized variables, invalidated with clearInstanceCache.

Definition at line 208 of file User.php.

User::$mOptionOverrides

Definition at line 176 of file User.php.

User::$mOptions

Definition at line 208 of file User.php.

User::$mOptionsLoaded

Bool Whether the cache variables have been loaded.

Definition at line 186 of file User.php.

User::$mPassword

Definition at line 176 of file User.php.

User::$mRealName

Definition at line 176 of file User.php.

User::$mRegistration

Definition at line 176 of file User.php.

WebRequest User::$mRequest [private]

Definition at line 214 of file User.php.

User::$mRights

Definition at line 208 of file User.php.

User::$mToken

Definition at line 176 of file User.php.

User::$mTouched

Definition at line 176 of file User.php.

Array User::$mWatchedItems = array() [private]

Definition at line 230 of file User.php.

Definition at line 66 of file User.php.

Maximum items in $mWatchedItems.

Definition at line 71 of file User.php.

Definition at line 65 of file User.php.

Global constants made accessible as class constants so that autoloader magic can be used.

Definition at line 64 of file User.php.


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