Notice: A major release has been issued since this post – Version 2.0
Changing the domain name or URL of a WordPress site can be a very frustrating and time consuming task.
I usually have three development environments that I’m constantly switching between and all of them have completely different domain names.
Fed up with all the steps needed to change the domain I decided it would be worth my time to build a script that could streamline the entire migration process. The first revision of this script was dirty and insecure (to say the least) but it significantly reduced the amount of time spent moving sites between servers and changing their domains.
In a later version I added functionality that allowed the script to read the
wp-config.php file and extract
$table_prefix. In addition to this I added five corresponding form fields and auto-populated them with the data parsed from the WordPress config file. This further reduced the amount of time spent setting up and running the domain change script.
When I started working on this latest revision I decided to go in another direction by developing the script into more of a standalone web application. I added simple authentication; better error checking; a console area displaying Errors, Notices, and Actions; and a “session” timeout feature all wrapped in a new user interface.
I’ve also added a mandatory 5 second wait (sleep) during authentication in order to combat the threat of a brute-force attack. However, even with this countermeasure in place it’s very important this script gets removed from the server as soon as the migration process has been completed.
How to Use / Instructions
- Backup your WordPress database.
- Seriously, Back Up Your Database!
- Situation One: You have a new server where you intend to upload your existing WordPress site files.
- Export the current WordPress database data into a SQL dump file.
- Create a MySQL database on the new server.
- Import the WordPress database dump file into the newly created database.
- Open up the wp-config.php file and set the
DB_NAMEconstants to the correct values for the new server.
- Upload the WordPress directory contents to the domain directory on the new server.
- Situation Two: The WordPress files and database locations have not changed — just the domain name.
- Coninue on to Step 5…
- Open up
wpdc/config.phpfile in a text editor and replace the default password with a VERY secure password of your choice.
- Upload the entire
wpdc/directory to the root directory of your WordPress site.
- Note: The root directory is where the wp-config.php is located.
- In a web browser go to:
- Type in the password that you set in step 6 at the authentication prompt.
- You will now be presented with the domain changer form.
- The script will try and auto-detect all of the settings, but it’s up to you to confirm they are all correct.
- Take one last look at the settings to verify that they are correct… then click the “Change Domain!”” button.
- Go to your site’s home page at the new domain — all should be working!
- Once the domain has been changed remove this
wpdc/directory from the server!
This class and its code is released under the New-BSD License.
- PHP >= 5.0, with the MySQLi Extension enabled.
- WordPress >= 2.8.0
- Untested on previous versions
The source code is available to anyone at http://github.com/veloper/WordPress-Domain-Changer.
If you’ve found an issue, improvement, or bug with this script please contact me or leave a comment.