3 define( 'NS_UNITTEST', 5600 );
4 define( 'NS_UNITTEST_TALK', 5601 );
9 class UserTest
extends MediaWikiTestCase
{
15 protected function setUp() {
18 $this->setMwGlobals( array(
19 'wgGroupPermissions' => array(),
20 'wgRevokePermissions' => array(),
23 $this->setUpPermissionGlobals();
25 $this->user
= new User
;
26 $this->user
->addGroup( 'unittesters' );
29 private function setUpPermissionGlobals() {
30 global $wgGroupPermissions, $wgRevokePermissions;
32 # Data for regular $wgGroupPermissions test
33 $wgGroupPermissions['unittesters'] = array(
39 $wgGroupPermissions['testwriters'] = array(
45 # Data for regular $wgRevokePermissions test
46 $wgRevokePermissions['formertesters'] = array(
50 # For the options test
51 $wgGroupPermissions['*'] = array(
52 'editmyoptions' => true,
57 * @covers User::getGroupPermissions
59 public function testGroupPermissions() {
60 $rights = User
::getGroupPermissions( array( 'unittesters' ) );
61 $this->assertContains( 'runtest', $rights );
62 $this->assertNotContains( 'writetest', $rights );
63 $this->assertNotContains( 'modifytest', $rights );
64 $this->assertNotContains( 'nukeworld', $rights );
66 $rights = User
::getGroupPermissions( array( 'unittesters', 'testwriters' ) );
67 $this->assertContains( 'runtest', $rights );
68 $this->assertContains( 'writetest', $rights );
69 $this->assertContains( 'modifytest', $rights );
70 $this->assertNotContains( 'nukeworld', $rights );
74 * @covers User::getGroupPermissions
76 public function testRevokePermissions() {
77 $rights = User
::getGroupPermissions( array( 'unittesters', 'formertesters' ) );
78 $this->assertNotContains( 'runtest', $rights );
79 $this->assertNotContains( 'writetest', $rights );
80 $this->assertNotContains( 'modifytest', $rights );
81 $this->assertNotContains( 'nukeworld', $rights );
85 * @covers User::getRights
87 public function testUserPermissions() {
88 $rights = $this->user
->getRights();
89 $this->assertContains( 'runtest', $rights );
90 $this->assertNotContains( 'writetest', $rights );
91 $this->assertNotContains( 'modifytest', $rights );
92 $this->assertNotContains( 'nukeworld', $rights );
96 * @dataProvider provideGetGroupsWithPermission
97 * @covers User::getGroupsWithPermission
99 public function testGetGroupsWithPermission( $expected, $right ) {
100 $result = User
::getGroupsWithPermission( $right );
104 $this->assertEquals( $expected, $result, "Groups with permission $right" );
107 public static function provideGetGroupsWithPermission() {
110 array( 'unittesters', 'testwriters' ),
114 array( 'unittesters' ),
118 array( 'testwriters' ),
122 array( 'testwriters' ),
129 * @dataProvider provideIPs
132 public function testIsIP( $value, $result, $message ) {
133 $this->assertEquals( $this->user
->isIP( $value ), $result, $message );
136 public static function provideIPs() {
138 array( '', false, 'Empty string' ),
139 array( ' ', false, 'Blank space' ),
140 array( '10.0.0.0', true, 'IPv4 private 10/8' ),
141 array( '10.255.255.255', true, 'IPv4 private 10/8' ),
142 array( '192.168.1.1', true, 'IPv4 private 192.168/16' ),
143 array( '203.0.113.0', true, 'IPv4 example' ),
144 array( '2002:ffff:ffff:ffff:ffff:ffff:ffff:ffff', true, 'IPv6 example' ),
145 // Not valid IPs but classified as such by MediaWiki for negated asserting
146 // of whether this might be the identifier of a logged-out user or whether
147 // to allow usernames like it.
148 array( '300.300.300.300', true, 'Looks too much like an IPv4 address' ),
149 array( '203.0.113.xxx', true, 'Assigned by UseMod to cloaked logged-out users' ),
154 * @dataProvider provideUserNames
155 * @covers User::isValidUserName
157 public function testIsValidUserName( $username, $result, $message ) {
158 $this->assertEquals( $this->user
->isValidUserName( $username ), $result, $message );
161 public static function provideUserNames() {
163 array( '', false, 'Empty string' ),
164 array( ' ', false, 'Blank space' ),
165 array( 'abcd', false, 'Starts with small letter' ),
166 array( 'Ab/cd', false, 'Contains slash' ),
167 array( 'Ab cd', true, 'Whitespace' ),
168 array( '192.168.1.1', false, 'IP' ),
169 array( 'User:Abcd', false, 'Reserved Namespace' ),
170 array( '12abcd232', true, 'Starts with Numbers' ),
171 array( '?abcd', true, 'Start with ? mark' ),
172 array( '#abcd', false, 'Start with #' ),
173 array( 'Abcdകഖഗഘ', true, ' Mixed scripts' ),
174 array( 'ജോസ്തോമസ്', false, 'ZWNJ- Format control character' ),
175 array( 'Ab cd', false, ' Ideographic space' ),
176 array( '300.300.300.300', false, 'Looks too much like an IPv4 address' ),
177 array( '302.113.311.900', false, 'Looks too much like an IPv4 address' ),
178 array( '203.0.113.xxx', false, 'Reserved for usage by UseMod for cloaked logged-out users' ),
183 * Test, if for all rights a right- message exist,
184 * which is used on Special:ListGroupRights as help text
185 * Extensions and core
187 public function testAllRightsWithMessage() {
188 // Getting all user rights, for core: User::$mCoreRights, for extensions: $wgAvailableRights
189 $allRights = User
::getAllRights();
190 $allMessageKeys = Language
::getMessageKeysFor( 'en' );
192 $rightsWithMessage = array();
193 foreach ( $allMessageKeys as $message ) {
194 // === 0: must be at beginning of string (position 0)
195 if ( strpos( $message, 'right-' ) === 0 ) {
196 $rightsWithMessage[] = substr( $message, strlen( 'right-' ) );
201 sort( $rightsWithMessage );
206 'Each user rights (core/extensions) has a corresponding right- message.'
211 * Test User::editCount
213 * @covers User::getEditCount
215 public function testEditCount() {
216 $user = User
::newFromName( 'UnitTestUser' );
218 if ( !$user->getId() ) {
219 $user->addToDatabase();
222 // let the user have a few (3) edits
223 $page = WikiPage
::factory( Title
::newFromText( 'Help:UserTest_EditCount' ) );
224 for ( $i = 0; $i < 3; $i++
) {
225 $page->doEdit( (string)$i, 'test', 0, false, $user );
228 $user->clearInstanceCache();
231 $user->getEditCount(),
232 'After three edits, the user edit count should be 3'
235 // increase the edit count and clear the cache
236 $user->incEditCount();
238 $user->clearInstanceCache();
241 $user->getEditCount(),
242 'After increasing the edit count manually, the user edit count should be 4'
247 * Test changing user options.
248 * @covers User::setOption
249 * @covers User::getOption
251 public function testOptions() {
252 $user = User
::newFromName( 'UnitTestUser' );
254 if ( !$user->getId() ) {
255 $user->addToDatabase();
258 $user->setOption( 'userjs-someoption', 'test' );
259 $user->setOption( 'cols', 200 );
260 $user->saveSettings();
262 $user = User
::newFromName( 'UnitTestUser' );
263 $this->assertEquals( 'test', $user->getOption( 'userjs-someoption' ) );
264 $this->assertEquals( 200, $user->getOption( 'cols' ) );
269 * Make sure defaults are loaded when setOption is called.
270 * @covers User::loadOptions
272 public function testAnonOptions() {
273 global $wgDefaultUserOptions;
274 $this->user
->setOption( 'userjs-someoption', 'test' );
275 $this->assertEquals( $wgDefaultUserOptions['cols'], $this->user
->getOption( 'cols' ) );
276 $this->assertEquals( 'test', $this->user
->getOption( 'userjs-someoption' ) );
280 * Test password expiration.
281 * @covers User::getPasswordExpired()
283 public function testPasswordExpire() {
284 global $wgPasswordExpireGrace;
285 $wgTemp = $wgPasswordExpireGrace;
286 $wgPasswordExpireGrace = 3600 * 24 * 7; // 7 days
288 $user = User
::newFromName( 'UnitTestUser' );
289 $user->loadDefaults( 'UnitTestUser' );
290 $this->assertEquals( false, $user->getPasswordExpired() );
292 $ts = time() - ( 3600 * 24 * 1 ); // 1 day ago
293 $user->expirePassword( $ts );
294 $this->assertEquals( 'soft', $user->getPasswordExpired() );
296 $ts = time() - ( 3600 * 24 * 10 ); // 10 days ago
297 $user->expirePassword( $ts );
298 $this->assertEquals( 'hard', $user->getPasswordExpired() );
300 $wgPasswordExpireGrace = $wgTemp;
304 * Test password validity checks. There are 3 checks in core,
305 * - ensure the password meets the minimal length
306 * - ensure the password is not the same as the username
307 * - ensure the username/password combo isn't forbidden
308 * @covers User::checkPasswordValidity()
309 * @covers User::getPasswordValidity()
310 * @covers User::isValidPassword()
312 public function testCheckPasswordValidity() {
313 $this->setMwGlobals( 'wgMinimalPasswordLength', 6 );
314 $user = User
::newFromName( 'Useruser' );
316 $this->assertTrue( $user->isValidPassword( 'Password1234' ) );
319 $this->assertFalse( $user->isValidPassword( 'a' ) );
320 $this->assertFalse( $user->checkPasswordValidity( 'a' )->isGood() );
321 $this->assertEquals( 'passwordtooshort', $user->getPasswordValidity( 'a' ) );
324 $this->assertFalse( $user->checkPasswordValidity( 'Useruser' )->isGood() );
325 $this->assertEquals( 'password-name-match', $user->getPasswordValidity( 'Useruser' ) );
327 // On the forbidden list
328 $this->assertFalse( $user->checkPasswordValidity( 'Passpass' )->isGood() );
329 $this->assertEquals( 'password-login-forbidden', $user->getPasswordValidity( 'Passpass' ) );
333 * @covers User::getCanonicalName()
334 * @dataProvider provideGetCanonicalName
336 public function testGetCanonicalName( $name, $expectedArray, $msg ) {
337 foreach ( $expectedArray as $validate => $expected ) {
339 User
::getCanonicalName( $name, $validate === 'false' ?
false : $validate ),
341 $msg . ' (' . $validate . ')'
346 public static function provideGetCanonicalName() {
348 array( ' trailing space ', array( 'creatable' => 'Trailing space' ), 'Trailing spaces' ),
349 // @todo FIXME: Maybe the createable name should be 'Talk:Username' or false to reject?
350 array( 'Talk:Username', array( 'creatable' => 'Username', 'usable' => 'Username',
351 'valid' => 'Username', 'false' => 'Talk:Username' ), 'Namespace prefix' ),
352 array( ' name with # hash', array( 'creatable' => false, 'usable' => false ), 'With hash' ),
353 array( 'Multi spaces', array( 'creatable' => 'Multi spaces',
354 'usable' => 'Multi spaces' ), 'Multi spaces' ),
355 array( 'lowercase', array( 'creatable' => 'Lowercase' ), 'Lowercase' ),
356 array( 'in[]valid', array( 'creatable' => false, 'usable' => false, 'valid' => false,
357 'false' => 'In[]valid' ), 'Invalid' ),
358 array( 'with / slash', array( 'creatable' => false, 'usable' => false, 'valid' => false,
359 'false' => 'With / slash' ), 'With slash' ),