Manual:changePassword.php
Jump to navigation
Jump to search
| MediaWiki file: changePassword.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.36.1 • 1.35.3 • 1.31.15 |
| Classes: | ChangePassword |
changePassword.php can be used to change the password of a user on your wiki. Note that passwords must have at least 10 characters.
Usage
The following examples assume that they are called from the /maintenance/ directory of the wiki code.
php changePassword.php --user=target_username --password=new_password
An example:
php changePassword.php --user=JohnSmith --password=Secret12
Usernames and passwords can have spaces, which will need to be protected from your shell (be it bash or cmd.exe; see Troubleshooting, below):
php changePassword.php --user="Anna Graham" --password="fierce sea ceasefire"
To display a help message:
php changePassword.php --help
Options
--user(the user's name)--password(the user's new password)--help(displays help message)
Troubleshooting
- If your MediaWiki installation uses a memory cache, such as APC, memcached or Redis, then the user object is cached. Thus after making SQL changes you must flush the cache before a user can log in with the new password.
- Windows has special challenges with parsing double-quoted strings, as when a username or password contains spaces in the second example above.
- Occasionally triple (
"""quoted string""") and quadruple sets of double quotes will solve your problems with Windows' command shell,cmd.exe. You may be happier, though, to try Cygwin and follow the Unix conventions for quoting strings, which are a bit more sane.
- Occasionally triple (
- There are no spaces between the parameter=value in the command line.
This will cause a cryptic error:
php changePassword.php --user = username --password = newpassword
Removing the spaces will fix the problem.