MediaWiki REL1_30
|
The CentralIdLookup service allows for connecting local users with cluster-wide IDs. More...
Public Member Functions | |
centralIdFromLocalUser (User $user, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given a local User object, return the central ID. | |
centralIdFromName ( $name, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given a (local) user name, return the central ID. | |
centralIdsFromNames (array $names, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given an array of (local) user names, return the central IDs. | |
getProviderId () | |
isAttached (User $user, $wikiId=null) | |
Check that a User is attached on the specified wiki. | |
localUserFromCentralId ( $id, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given a central user ID, return a local User object. | |
lookupCentralIds (array $idToName, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given central user IDs, return the (local) user names. | |
lookupUserNames (array $nameToId, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given (local) user names, return the central IDs. | |
nameFromCentralId ( $id, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given a central user ID, return the (local) user name. | |
namesFromCentralIds (array $ids, $audience=self::AUDIENCE_PUBLIC, $flags=self::READ_NORMAL) | |
Given a an array of central user IDs, return the (local) user names. | |
Static Public Member Functions | |
static | factory ( $providerId=null) |
Fetch a CentralIdLookup. | |
static | resetCache () |
Reset internal cache for unit testing. | |
Public Attributes | |
const | AUDIENCE_PUBLIC = 1 |
const | AUDIENCE_RAW = 2 |
Public Attributes inherited from IDBAccessObject | |
const | READ_LOCKING = 3 |
Constants for object loading bitfield flags (higher => higher QoS) | |
const | READ_NONE = -1 |
Protected Member Functions | |
checkAudience ( $audience) | |
Check that the "audience" parameter is valid. | |
Private Attributes | |
string | $providerId |
Static Private Attributes | |
static CentralIdLookup[] | $instances = [] |
The CentralIdLookup service allows for connecting local users with cluster-wide IDs.
Definition at line 29 of file CentralIdLookup.php.
CentralIdLookup::centralIdFromLocalUser | ( | User | $user, |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given a local User object, return the central ID.
User | $user | Local user |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 254 of file CentralIdLookup.php.
References $flags, centralIdFromName(), User\getName(), and isAttached().
CentralIdLookup::centralIdFromName | ( | $name, | |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given a (local) user name, return the central ID.
string | $name | Canonicalized user name |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 191 of file CentralIdLookup.php.
References $flags, $name, and lookupUserNames().
Referenced by centralIdFromLocalUser().
CentralIdLookup::centralIdsFromNames | ( | array | $names, |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given an array of (local) user names, return the central IDs.
string[] | $names | Canonicalized user names |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 206 of file CentralIdLookup.php.
References $flags, and lookupUserNames().
|
protected |
Check that the "audience" parameter is valid.
int | User | $audience | One of the audience constants, or a specific user |
InvalidArgumentException |
Definition at line 87 of file CentralIdLookup.php.
Referenced by LocalIdLookup\lookupCentralIds(), and LocalIdLookup\lookupUserNames().
|
static |
Fetch a CentralIdLookup.
string | null | $providerId | Provider ID from $wgCentralIdLookupProviders |
Definition at line 45 of file CentralIdLookup.php.
References $providerId, $wgCentralIdLookupProvider, and $wgCentralIdLookupProviders.
Referenced by SpecialBotPasswords\checkExecutePermissions(), ApiQueryUserInfo\getCentralUserInfo(), BotPassword\invalidateAllPasswordsForUser(), BotPassword\newFromUser(), BotPassword\newUnsaved(), Preferences\profilePreferences(), BotPassword\removeAllPasswordsForUser(), User\saveOptions(), ApiLoginTest\testBotPassword(), CentralIdLookupTest\testFactory(), and SpecialEmailUser\validateTarget().
|
final |
Definition at line 77 of file CentralIdLookup.php.
References $providerId.
|
abstract |
Check that a User is attached on the specified wiki.
If unattached local accounts don't exist in your extension, this comes down to a check whether the central account exists at all and that $wikiId is using the same central database.
User | $user | |
string | null | $wikiId | Wiki to check attachment status. If null, check the current wiki. |
Reimplemented in LocalIdLookup.
Referenced by centralIdFromLocalUser().
CentralIdLookup::localUserFromCentralId | ( | $id, | |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given a central user ID, return a local User object.
int | $id | Central user ID |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 230 of file CentralIdLookup.php.
References $flags, $user, and nameFromCentralId().
|
abstract |
Given central user IDs, return the (local) user names.
array | $idToName | Array with keys being central user IDs |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Reimplemented in LocalIdLookup.
Referenced by nameFromCentralId(), and namesFromCentralIds().
|
abstract |
Given (local) user names, return the central IDs.
array | $nameToId | Array with keys being canonicalized user names |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Reimplemented in LocalIdLookup.
Referenced by centralIdFromName(), and centralIdsFromNames().
CentralIdLookup::nameFromCentralId | ( | $id, | |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given a central user ID, return the (local) user name.
int | $id | Central user ID |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 153 of file CentralIdLookup.php.
References $flags, and lookupCentralIds().
Referenced by localUserFromCentralId().
CentralIdLookup::namesFromCentralIds | ( | array | $ids, |
$audience = self::AUDIENCE_PUBLIC, | |||
$flags = self::READ_NORMAL ) |
Given a an array of central user IDs, return the (local) user names.
int[] | $ids | Central user IDs |
int | User | $audience | One of the audience constants, or a specific user |
int | $flags | IDBAccessObject read flags |
Definition at line 168 of file CentralIdLookup.php.
References $flags, and lookupCentralIds().
|
static |
Reset internal cache for unit testing.
Definition at line 70 of file CentralIdLookup.php.
Referenced by BotPasswordTest\setUp().
|
staticprivate |
Definition at line 35 of file CentralIdLookup.php.
|
private |
Definition at line 38 of file CentralIdLookup.php.
Referenced by factory(), and getProviderId().
const CentralIdLookup::AUDIENCE_PUBLIC = 1 |
Definition at line 31 of file CentralIdLookup.php.
Referenced by CentralIdLookupTest\testCheckAudience().
const CentralIdLookup::AUDIENCE_RAW = 2 |
Definition at line 32 of file CentralIdLookup.php.
Referenced by BotPassword\invalidateAllPasswordsForUser(), BotPassword\newFromUser(), BotPassword\newUnsaved(), BotPassword\removeAllPasswordsForUser(), CentralIdLookupTest\testCentralIdFromLocalUser(), CentralIdLookupTest\testCentralIdFromName(), CentralIdLookupTest\testCheckAudience(), CentralIdLookupTest\testLocalUserFromCentralId(), LocalIdLookupTest\testLookupCentralIds(), LocalIdLookupTest\testLookupUserNames(), and CentralIdLookupTest\testNameFromCentralId().