How to Migrate a PHP Website to a New Server: 9 Easy Steps - Learn Java Online, Learn Python Online, Learn Laravel Online, Learn PHP Online

How to Migrate a PHP Website to a New Server is an important skill for PHP developers, website administrators, freelancers, and beginners who manage websites hosted on Linux or other web servers.

A PHP website migration means moving your website from one server to another while keeping the website files, database, configuration, dependencies, uploads, and other required resources working correctly.

You may want to migrate a PHP website because:

Your current hosting provider is too slow.
You are moving to a VPS.
You are changing hosting companies.
You need better server resources.
You are moving from development to production.
You are replacing an old server.
You need a different PHP version.
You want to move your website to a cloud server.
You need better security or performance.

Learning How to Migrate a PHP Website to a New Server is easier when you divide the process into separate parts.

A typical PHP website migration looks like this:

Old Server
   |
   |-- PHP Website Files
   |-- Database
   |-- Configuration
   |-- Uploads
   |-- Dependencies
   |
   v
Backup
   |
   v
New Server
   |
   |-- PHP
   |-- Web Server
   |-- Database
   |-- Extensions
   |
   v
Upload Files
   |
   v
Import Database
   |
   v
Configure Website
   |
   v
Test
   |
   v
DNS + SSL
   |
   v
Live Website

The exact migration steps depend on your PHP framework and hosting environment. A plain PHP website, Laravel application, CodeIgniter application, and custom PHP application may require different configuration. How to Migrate a PHP Website to a New Server should always include this verification step.

In this guide, you will learn How to Migrate a PHP Website to a New Server using a practical, beginner-friendly process that works as a foundation for most PHP websites.

What Is a PHP Website Migration?

Before learning How to Migrate a PHP Website to a New Server, it is important to understand what actually needs to be moved.

A PHP website is usually made up of several components:

PHP source files
HTML files
CSS files
JavaScript files
Images
Uploaded files
Configuration files
Database
Composer dependencies
Environment variables
Web server configuration
SSL certificate
Scheduled tasks or cron jobs

For example, a simple PHP application might look like:

public_html/
├── index.php
├── config.php
├── login.php
├── dashboard.php
├── css/
├── js/
├── images/
└── uploads/

A more advanced PHP application may look like:

project/
├── app/
├── config/
├── public/
├── resources/
├── routes/
├── storage/
├── vendor/
├── .env
└── composer.json

Therefore, How to Migrate a PHP Website to a New Server is not simply copying files. You also need to make sure that the new server has the correct PHP version, extensions, database, permissions, configuration, and web-server settings.

How to Migrate a PHP Website to a New Server Step by Step

Now let’s learn How to Migrate a PHP Website to a New Server step by step.

For this tutorial, assume:

Old Server:
old-server.example.com

New Server:
new-server.example.com

Website:
example.com

Database:
example_db

These are example values. Replace them with your actual server, domain, database, and username. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 1: Check the Current PHP Website Environment

The first step in How to Migrate a PHP Website to a New Server is understanding your existing environment.

Before moving anything, record:

PHP version
Web server
Database type
Database version
PHP extensions
Website directory
Database name
Database username
Database host
Cron jobs
SSL configuration
DNS settings
Environment variables
Composer dependencies

Check the PHP Version

Run:

php -v

You may see:

PHP 8.3.x

You can also check the PHP version from inside a PHP script:

<?php
echo phpversion();
?>

PHP provides the phpversion() function for retrieving the currently running PHP parser version. (php.net)

Why Is the PHP Version Important?

Your website may depend on a specific PHP version.

For example, an older application might have been written for PHP 7.x, while the new server may use PHP 8.x.

Moving the website and changing PHP versions at the same time can introduce compatibility problems.

PHP maintains an official supported-version list, and unsupported PHP branches should be upgraded because they no longer receive normal security support. (php.net)

Therefore, when learning How to Migrate a PHP Website to a New Server, do not automatically upgrade PHP just because the new server has a newer version.

First test your application against the new PHP version.

Step 2: Check Required PHP Extensions

The next step in How to Migrate a PHP Website to a New Server is identifying the PHP extensions used by your website.

Run:

php -m

This displays installed PHP modules.

Common PHP extensions include:

mysqli
pdo_mysql
curl
mbstring
openssl
json
xml
zip
gd
intl
fileinfo

Your application may require only some of these.

For example, a PHP application using MySQL may require:

pdo_mysql

A website processing images may require:

gd

An application making HTTP requests may require:

curl

If the new server does not have a required extension, the website may show errors even when all files have been copied correctly.

Step 3: Check the Web Server

Before continuing How to Migrate a PHP Website to a New Server, identify whether your current website uses:

Apache
Nginx
LiteSpeed
Another web server

Run:

apache2 -v

if you use Apache.

For Nginx:

nginx -v

The web server configuration may contain important settings such as:

Document root
URL rewriting
PHP-FPM configuration
Redirects
HTTPS
Security headers
Cache rules
Custom locations

You need to reproduce the required settings on the new server.

Step 4: Create a Complete Website Backup

A complete backup is one of the most important parts of How to Migrate a PHP Website to a New Server.

Do not start the migration without a backup.

Your backup should include:

PHP files
CSS
JavaScript
Images
Uploads
Configuration files
Database
Composer files
.htaccess
Environment configuration

If your website is inside:

/var/www/example.com/

you can create an archive:

tar -czf example.com-files.tar.gz /var/www/example.com/

You can then verify the file:

ls -lh example.com-files.tar.gz

For a hosting panel, you may also be able to use File Manager to create and download a ZIP archive.

Keep the Original Website

Do not immediately delete the old website.

Keep it available until:

The new website works.
The database is verified.
DNS is updated.
HTTPS works.
Forms work.
Login works.
Important pages work.
No major errors remain.

This gives you a recovery option if something goes wrong. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 5: Back Up the Database

The database is another critical part of How to Migrate a PHP Website to a New Server.

Many PHP websites use MySQL or MariaDB.

Check the database configuration in your application.

For example:

$db_host = "localhost";
$db_name = "example_db";
$db_user = "example_user";
$db_password = "your-password";

Once you know the database name, create a backup.

For MySQL:

mysqldump -u root -p example_db > example_db.sql

You can compress it:

mysqldump -u root -p example_db | gzip > example_db.sql.gz

MySQL’s official documentation describes mysqldump as a way to create a SQL dump that can be transferred to another machine and loaded into the target MySQL server. (dev.mysql.com

Check the backup:

ls -lh example_db.sql.gz

Keep this database backup separate from the website files. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 6: Prepare the New Server

The next stage of How to Migrate a PHP Website to a New Server is preparing the destination server.

The new server should have the software required by your application.

Depending on your website, this may include:

Linux
Apache or Nginx
PHP
PHP-FPM
MySQL or MariaDB
Composer
Git
Required PHP extensions
SSL
Cron
Firewall configuration

Install PHP

The exact installation command depends on your Linux distribution and required PHP version.

After installation, verify:

php -v

Then check extensions:

php -m

Compare the result with the old server. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 7: Match the PHP Version

Matching the PHP version is especially important when learning How to Migrate a PHP Website to a New Server.

Suppose the old server uses:

PHP 8.2

and the new server uses:

PHP 8.5

The application may work, but you should test it before switching production traffic.

PHP publishes migration guides for changes between major and minor versions, including backward-incompatible changes and deprecated functionality. (php.net

If your application uses an old PHP version, consider upgrading it separately from the server migration.

A safer approach can be:

Old Server
PHP 8.2
   |
   v
New Server
PHP 8.2
   |
   v
Test Website
   |
   v
Upgrade PHP Later

This makes troubleshooting easier because you are not changing two major variables at the same time.

Step 8: Create the Database on the New Server

Now create the target database.

mysql -u root -p

Create the database:

CREATE DATABASE example_db;

Create a dedicated database user:

CREATE USER 'example_user'@'localhost'
IDENTIFIED BY 'StrongPasswordHere';

Grant access:

GRANT ALL PRIVILEGES ON example_db.*
TO 'example_user'@'localhost';

Then:

FLUSH PRIVILEGES;

Use a strong and unique database password.

Do not use the MySQL root account inside your website configuration unless there is a specific reason and appropriate security controls.

Step 9: Import the Database

The next step in How to Migrate a PHP Website to a New Server is importing the old database.

If you have:

example_db.sql

run:

mysql -u example_user -p example_db < example_db.sql

If the backup is compressed:

example_db.sql.gz

run:

gunzip < example_db.sql.gz | mysql -u example_user -p example_db

MySQL’s official documentation provides the same general dump-and-reload workflow for moving databases between machines. (dev.mysql.com

After importing, check the tables:

mysql -u example_user -p

Then:

USE example_db;
SHOW TABLES;

You should see the tables used by your application.

Step 10: Upload the PHP Website Files

Now you can transfer the website files.

You can use:

SFTP
SCP
rsync
FTP
Hosting File Manager
Git
Secure cloud storage

For Linux servers, SCP is a simple option.

For example:

scp example.com-files.tar.gz user@NEW_SERVER:/home/user/

Connect to the new server:

ssh user@NEW_SERVER

Extract the archive:

tar -xzf example.com-files.tar.gz

Move the files into the correct web directory.

For example:

/var/www/example.com/

The final structure might look like: How to Migrate a PHP Website to a New Server should always include this verification step.

/var/www/example.com/
├── index.php
├── config.php
├── css/
├── js/
├── images/
└── uploads/

For a framework-based application, the structure may be different.

Step 11: Configure the PHP Application

This is one of the most important steps in How to Migrate a PHP Website to a New Server.

Your PHP application may contain configuration files such as:

config.php
.env
database.php
settings.php

Update the database settings.

For example:

$db_host = "localhost";
$db_name = "example_db";
$db_user = "example_user";
$db_password = "StrongPasswordHere";

Or an application may use:

DB_HOST=localhost
DB_DATABASE=example_db
DB_USERNAME=example_user
DB_PASSWORD=StrongPasswordHere

Do not assume every PHP application uses the same configuration format. How to Migrate a PHP Website to a New Server should always include this verification step.

Protect Configuration Files

Configuration files can contain:

Database passwords
API keys
SMTP credentials
Encryption keys
Third-party service credentials

Do not expose these files through the web server.

Step 12: Configure Composer Dependencies

If your PHP website uses Composer, look for:

composer.json
composer.lock

Instead of manually copying the vendor directory, you may be able to install dependencies on the new server.

Run:

composer install --no-dev --optimize-autoloader

For production environments, the exact Composer command should match your application’s deployment process.

Composer’s dependency management ensures that your PHP application gets the packages specified by the project.

If Composer is not installed, install it according to the official Composer documentation.

You can use the official Composer documentation as a reference.

Step 13: Configure the Web Server

The next step in How to Migrate a PHP Website to a New Server is configuring Apache or Nginx.

For Apache, a virtual host might look like:

<VirtualHost *:80>

    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /var/www/example.com

    <Directory /var/www/example.com>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/example.com-error.log
    CustomLog ${APACHE_LOG_DIR}/example.com-access.log combined

</VirtualHost>

Enable the site:

sudo a2ensite example.com.conf

Test the Apache configuration:

sudo apache2ctl configtest

If you see:

Syntax OK

reload Apache:

sudo systemctl reload apache2

If your new server uses Nginx, you will need an Nginx server block and usually PHP-FPM configuration instead.

Step 14: Configure PHP-FPM if Required

Modern PHP deployments often use PHP-FPM rather than loading PHP directly into Apache.

Check the PHP-FPM service:

sudo systemctl status php8.3-fpm

The exact version depends on your installation.

For Nginx, a configuration may contain:

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

The exact PHP-FPM socket path depends on the installed PHP version and operating system.

Make sure the web server is using the same PHP version that you tested. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 15: Check PHP Configuration

The new server may have different PHP settings.

Important settings can include:

memory_limit
upload_max_filesize
post_max_size
max_execution_time
max_input_time
max_input_vars
max_file_uploads

You can check the current configuration with:

php --ini

and:

php -i

PHP reads its main configuration from php.ini, and the exact configuration location depends on the PHP SAPI and environment. (php.net

For example, if users upload large files, you may need:

upload_max_filesize = 64M
post_max_size = 64M

Do not blindly copy the entire old php.ini to the new server. Compare the important settings and apply only those required by your application. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 16: Configure File Permissions

Incorrect permissions can cause problems after How to Migrate a PHP Website to a New Server.

For example:

sudo chown -R www-data:www-data /var/www/example.com

Then:

sudo find /var/www/example.com -type d -exec chmod 755 {} \;

And:

sudo find /var/www/example.com -type f -exec chmod 644 {} \;

Your exact ownership model may differ if deployments are performed by another user or process. How to Migrate a PHP Website to a New Server should always include this verification step.

Avoid:

chmod -R 777

unless you have a very specific reason and understand the security implications.

Step 17: Configure Cron Jobs

Some PHP websites depend on scheduled tasks.

For example:

Daily reports
Email notifications
Database cleanup
Queue processing
Subscription renewals
Backups
Scheduled imports

Check the old server’s cron jobs:

crontab -l

Also check system-wide cron configuration where applicable. How to Migrate a PHP Website to a New Server should always include this verification step.

If the application uses a cron command such as:

php /var/www/example.com/cron.php

recreate the required job on the new server.

Do not forget cron jobs when learning How to Migrate a PHP Website to a New Server because the website may appear to work while background tasks silently stop.

Step 18: Configure SSL/HTTPS

After the PHP website is working on the new server, configure HTTPS.

Your website should eventually be available at:

https://example.com

Check:

SSL certificate
Certificate chain
HTTP-to-HTTPS redirect
CSS
JavaScript
Images
API calls
Forms

If you use Let’s Encrypt, configure a certificate on the new server before switching production traffic.

Also check whether your PHP application has hard-coded http:// URLs.

Step 19: Test the Website Before Changing DNS

This is an important part of How to Migrate a PHP Website to a New Server.

Do not change DNS immediately.

First test the new server.

Check:

Homepage

https://example.com

Login

Test the website login.

Registration

Create a test account if applicable.

Database Operations

Test:

Create
Read
Update
Delete

where appropriate.

File Uploads

Upload a test file.

Emails

Test contact forms and transactional email.

API Connections

If your website uses external APIs, verify the API requests.

Admin Dashboard

Check the complete administration area.

Scheduled Tasks

Confirm cron jobs are running.

How to Test a PHP Website Before DNS Changes

One useful approach is to test the new server using a temporary hostname or local hosts-file entry.

For example, on your local computer you can temporarily map:

203.0.113.20 example.com

to the new server IP.

This lets your computer access the new server while most other visitors continue reaching the old server.

Remove the temporary entry after testing.

This method is useful because you can identify problems before changing public DNS. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 20: Update DNS

Once the new PHP website has been tested, update the domain’s DNS records.

For an IPv4 address, you may use:

Type: A
Name: @
Value: NEW_SERVER_IP

For www, you might use:

Type: CNAME
Name: www
Value: example.com

Your actual DNS records depend on your domain and hosting provider.

After changing DNS, some users may continue reaching the old server for a while because DNS information can be cached.

Do not immediately shut down the old server. How to Migrate a PHP Website to a New Server should always include this verification step.

Step 21: Monitor the New PHP Website

After DNS changes, monitor the website.

Check:

Apache/Nginx logs
PHP errors
Database errors
Application logs
Login failures
404 errors
500 errors
Email delivery
File uploads
API failures

For Apache, you can check:

sudo tail -f /var/log/apache2/error.log

For Nginx:

sudo tail -f /var/log/nginx/error.log

Your PHP application’s own log location depends on the application. How to Migrate a PHP Website to a New Server should always include this verification step.

Common PHP Migration Problems

Even after following How to Migrate a PHP Website to a New Server, you may encounter problems.

1. 500 Internal Server Error

A 500 error may be caused by:

PHP fatal errors
Incorrect permissions
Invalid .htaccess
Missing PHP extensions
Incorrect web-server configuration
PHP version incompatibility

First check your web-server and PHP logs. How to Migrate a PHP Website to a New Server should always include this verification step.

2. Error Establishing Database Connection

Check:

Database host
Database name
Database username
Database password
Database permissions

Test the credentials manually:

mysql -u example_user -p example_db

If the connection fails, fix the database configuration before troubleshooting the PHP code. How to Migrate a PHP Website to a New Server should always include this verification step.

3. Missing PHP Extension

You may see an error such as:

Call to undefined function ...

or:

Class not found

Check:

php -m

Compare the extensions with the old server. How to Migrate a PHP Website to a New Server should always include this verification step.

Install the missing extension according to your Linux distribution and PHP version.

4. PHP Version Error

The application may have been developed for an older PHP version.

You might see warnings or fatal errors after moving to a newer PHP release.

Check:

php -v

If the versions differ, determine whether the application supports the new version.

PHP’s official migration documentation provides details about backward-incompatible changes between releases. (php.net

5. File Uploads Are Not Working

Check:

upload_max_filesize
post_max_size

You can inspect them with:

php -i | grep upload_max_filesize

and:

php -i | grep post_max_size

Also check directory permissions. How to Migrate a PHP Website to a New Server should always include this verification step.

6. CSS or JavaScript Is Missing

If the website loads but looks broken, check:

Asset paths
File permissions
HTTPS
Browser console
Cache
CDN settings
Web-server configuration

Open browser developer tools and look for 404 errors.

7. Rewrite Rules Are Not Working

If friendly URLs stop working after migration, check your web-server rewrite configuration.

For Apache, make sure the required rewrite module is enabled:

sudo a2enmod rewrite

Then check your .htaccess.

For Nginx, rewrite behavior is normally configured directly in the server block rather than through .htaccess.

How to Migrate a PHP Website to a New Server Without Changing the Domain

If you are only changing the server but keeping the same domain, the migration is relatively straightforward.

For example:

Old Server
     ↓
example.com
     ↓
New Server
     ↓
example.com

You usually need to:

Back up the website.
Back up the database.
Prepare the new server.
Install the required PHP version.
Install required PHP extensions.
Create the database.
Import the database.
Upload the website files.
Configure the application.
Configure the web server.
Configure HTTPS.
Test the new server.
Update DNS.
Monitor the new server.

Because the domain remains unchanged, you normally do not need a database-wide URL replacement.

How to Migrate a PHP Website to a New Server and Domain

Changing the domain makes How to Migrate a PHP Website to a New Server more complicated.

For example:

Old:
https://oldsite.com

New:
https://newsite.com

You may need to update:

Application configuration
Database URLs
Redirects
Absolute links
API callback URLs
Email links
CORS settings
OAuth redirect URLs
Webhook URLs
SSL certificate
DNS records

Search the project for the old domain:

grep -R "oldsite.com" /var/www/example.com

Be careful when performing automated replacements.

If the old URL is stored inside serialized PHP data or application-specific formats, blindly replacing text may corrupt the data.

Always back up the database before changing stored URLs.

How to Migrate a Laravel Website to a New Server

If your PHP website is a Laravel application, How to Migrate a PHP Website to a New Server requires several additional steps.

Typical Laravel files include:

app/
bootstrap/
config/
database/
public/
resources/
routes/
storage/
vendor/
.env
artisan
composer.json

A common deployment workflow is:

composer install --no-dev --optimize-autoloader

Then configure:

.env

with the correct database credentials.

You may also need:

php artisan migrate

only when your deployment process requires running pending migrations.

Be careful not to run destructive database commands against production.

Laravel applications may also require:

php artisan config:cache
php artisan route:cache
php artisan view:cache

depending on the Laravel version and deployment setup.

Make sure the storage and bootstrap/cache directories have the appropriate permissions.

How to Migrate a PHP Website Using Composer

If your application uses Composer, check:

composer.json
composer.lock

Copy both files to the new server.

Then run:

composer install --no-dev --optimize-autoloader

The composer.lock file helps ensure that the application uses the locked dependency versions.

If the old server contains a vendor directory, you can copy it, but installing dependencies on the target server is often cleaner when the deployment environment is configured correctly.

Always test the application after installing dependencies. How to Migrate a PHP Website to a New Server should always include this verification step.

How to Migrate a PHP Website With Uploaded Files

If your application allows users to upload:

Images
Documents
PDFs
Videos
Profile pictures

make sure the complete upload directory is transferred.

For example:

/uploads/

or:

storage/app/public/

depending on the application.

Missing uploads can cause hundreds or thousands of broken links after migration.

Before changing DNS, verify several old and recent uploaded files.

How to Migrate a PHP Website With Minimal Downtime

If your PHP website receives constant traffic, you should plan the final cutover carefully.

A simple migration can use this workflow:

Backup
   ↓
Copy Files
   ↓
Copy Database
   ↓
Configure New Server
   ↓
Test
   ↓
Put Website in Maintenance Mode
   ↓
Take Final Database Backup
   ↓
Import Final Changes
   ↓
Final Test
   ↓
Change DNS
   ↓
Monitor

For applications with strict uptime requirements, more advanced techniques such as database replication, load balancing, or blue-green deployment may be appropriate.

For a small PHP website, a short maintenance window is usually easier and safer.

Security Best Practices During PHP Migration

Security should be part of How to Migrate a PHP Website to a New Server.

Use Secure File Transfer

Prefer:

SFTP
SCP
rsync over SSH

when transferring sensitive website files.

Protect Database Backups

A database dump can contain sensitive information.

Never place:

database.sql
database.sql.gz

inside a publicly accessible website directory.

Protect Environment Files

Files such as:

.env

may contain database passwords and API keys.

Make sure they cannot be downloaded through the browser.

Use Supported PHP Versions

Do not continue using unsupported PHP branches simply because the application currently works.

PHP’s official supported-version page lists current support periods, while unsupported branches no longer receive normal security updates. (php.net)

Use HTTPS

Always configure HTTPS for production websites.

Restrict Database Access

If MySQL runs on another server, restrict network access to the application servers that actually need it.

Remove Temporary Files

After migration, remove:

SQL dumps from public directories
Temporary archives
Debug files
Test scripts
Temporary credentials

Best Practices for Migrating a PHP Website

When learning How to Migrate a PHP Website to a New Server, follow these best practices:

1. Create a Complete Backup

Back up files and database separately.

2. Record the Existing Environment

Write down PHP version, extensions, database version, web server, cron jobs, and configuration.

3. Test PHP Compatibility

Do not change PHP versions without testing.

4. Prepare the New Server Before DNS Changes

Get everything ready first.

5. Test Before Going Live

Use a temporary hostname or hosts-file entry.

6. Protect Credentials

Keep database passwords and API keys private.

7. Verify File Permissions

Use the minimum permissions required.

8. Check Cron Jobs

Background processes are easy to forget.

9. Configure SSL

Test HTTPS before switching production traffic.

10. Keep the Old Server Temporarily

Do not delete the original environment immediately.

Useful PHP Migration Commands

Here are some useful commands for How to Migrate a PHP Website to a New Server.

Check PHP Version

php -v

List PHP Modules

php -m

Show PHP Configuration

php --ini

Check PHP Information

php -i

Create a Website Archive

tar -czf website-backup.tar.gz /var/www/example.com/

Export MySQL Database

mysqldump -u root -p example_db > example_db.sql

Compress Database Backup

mysqldump -u root -p example_db | gzip > example_db.sql.gz

Transfer Files With SCP

scp website-backup.tar.gz user@NEW_SERVER:/home/user/

Transfer Database Backup

scp example_db.sql.gz user@NEW_SERVER:/home/user/

Extract Website Files

tar -xzf website-backup.tar.gz

Import Database

mysql -u example_user -p example_db < example_db.sql

Check Apache Configuration

sudo apache2ctl configtest

Check Apache Status

sudo systemctl status apache2

Check Nginx Configuration

sudo nginx -t

Check Nginx Status

sudo systemctl status nginx

PHP Website Migration Checklist

Use this checklist when following How to Migrate a PHP Website to a New Server.

Record current PHP version.
Record PHP extensions.
Record web-server software.
Record database version.
Record database credentials.
Record cron jobs.
Back up website files.
Back up the database.
Verify the backups.
Prepare the new server.
Install the required PHP version.
Install required PHP extensions.
Install the required web server.
Install MySQL or MariaDB.
Create the target database.
Create the database user.
Import the database.
Upload PHP files.
Install Composer dependencies if required.
Configure .env or application settings.
Configure the web server.
Configure PHP-FPM if required.
Set file permissions.
Configure cron jobs.
Configure SSL.
Test the website.
Test database operations.
Test file uploads.
Test email.
Test APIs.
Test login.
Update DNS.
Monitor logs.
Keep the old server temporarily.

Internal Resources

You can connect this tutorial with other related server-management tutorials on your website.

For example:

How to Configure Apache Virtual Hosts
How to Configure Nginx for a Website
How to Point a Subdomain to a Server
How to Set Up a Staging Subdomain
How to Create Scheduled Website Backups
How to Migrate a MySQL Database Between Servers

Use the actual published URLs of these articles when adding internal links in WordPress.

For example, a natural internal link can be added here:

If you are using Apache on the new server, follow our guide on How to Configure Apache Virtual Hosts to configure the domain and document root.

Another useful placement is:

Before migrating the database, create a reliable backup by following our guide on How to Create Scheduled Website Backups.

These internal links help readers discover related tutorials and strengthen the site’s internal linking structure.

External Resources

The following official resources provide additional information related to PHP, MySQL, and server migration.

PHP Supported Versions — Check which PHP branches currently receive active or security support. (php.net
PHP Configuration File Documentation — Learn how PHP reads and uses php.ini configuration. (php.net
PHP Version Information — Official documentation for checking the PHP version programmatically. (php.net
MySQL: Copying Databases to Another Machine — Official MySQL documentation for transferring databases between servers using mysqldump and the MySQL client. (dev.mysql.com
MySQL: mysqldump Documentation — Official reference for creating and restoring MySQL dumps. (dev.mysql.com
Composer Documentation — Official documentation for managing PHP dependencies with Composer.

These are normal external links. In WordPress, make sure you do not add rel="nofollow" to these links if you want them to count as DoFollow outbound links.

Frequently Asked Questions

How to Migrate a PHP Website to a New Server?

To learn How to Migrate a PHP Website to a New Server, back up the website files and database, prepare the new server, install the required PHP version and extensions, create and import the database, upload the website files, update the configuration, configure the web server, test the website, and finally update DNS.

Can I migrate a PHP website without changing the domain?

Yes. You can move the website to a new server while keeping the same domain. After testing the new server, update the domain’s DNS records to point to the new server.

Do I need to migrate the database?

If the PHP website uses a database, yes. The database may contain users, products, orders, settings, content, and other application data.

Can I migrate a PHP website to a different PHP version?

Yes, but you should test the application for compatibility first. PHP versions can introduce backward-incompatible changes and deprecated functionality. (php.net

How do I check the PHP version?

Run:

php -v

You can also use PHP’s phpversion() function. (php.net

How do I migrate a PHP website with MySQL?

Back up the PHP files, export the MySQL database with mysqldump, transfer the files and database backup, create the database on the new server, import the dump, update application credentials, and test the application.

Do I need to install PHP extensions on the new server?

Yes. If your application depends on PHP extensions that are not installed on the new server, some features may fail.

What happens if the PHP version is different after migration?

The website may continue working, but it can also produce warnings or fatal errors if the application uses removed or changed PHP functionality. Test the application before switching production traffic.

Why does my PHP website show a 500 error after migration?

A 500 error can be caused by PHP errors, incorrect permissions, missing extensions, invalid web-server configuration, incompatible PHP versions, or incorrect application settings.

Check the PHP and web-server error logs first.

Why is my PHP website not connecting to MySQL after migration?

Check the database host, database name, username, password, port, and permissions. Test the database credentials separately from the PHP application.

Do I need Composer after migrating a PHP website?

If your PHP application uses Composer, you should generally install its dependencies on the new server using the project’s composer.json and composer.lock files.

Should I delete the old server immediately?

No. Keep the old server and backups until the new website has been fully tested and the DNS migration is confirmed.

How long does a PHP website migration take?

The time depends on website size, database size, server configuration, DNS changes, application complexity, and testing requirements. A small PHP website may be migrated relatively quickly, while a large application can require extensive preparation and testing.

Final Verification

After completing How to Migrate a PHP Website to a New Server, perform one final review.

Check:

PHP Version
     ↓
PHP Extensions
     ↓
Web Server
     ↓
Website Files
     ↓
Database
     ↓
Application Configuration
     ↓
Composer Dependencies
     ↓
File Permissions
     ↓
Cron Jobs
     ↓
SSL
     ↓
Website Testing
     ↓
DNS
     ↓
Monitoring

Open the website and test the most important features.

Do not test only the homepage.

Test:

Login
Registration
Forms
Database queries
File uploads
Admin panel
API integrations
Email
Search
Payments if applicable
Scheduled tasks

A migration is complete only when the application works correctly on the new server.

Conclusion

How to Migrate a PHP Website to a New Server is a practical skill that every PHP developer and website administrator can benefit from learning.

The basic migration process involves backing up the website, exporting the database, preparing the new server, installing the correct PHP environment, transferring the files, importing the database, updating application configuration, installing dependencies, configuring the web server, setting permissions, testing the website, configuring HTTPS, and finally updating DNS.

The most important part is preparation.

Before starting How to Migrate a PHP Website to a New Server, record the existing PHP version, PHP extensions, database version, web server, application configuration, cron jobs, and other dependencies. This information makes it much easier to reproduce the working environment on the new server.

You should also avoid changing too many things at once. For example, if the old website uses PHP 8.2, consider initially migrating it to a server running the same supported PHP branch. Once the application works correctly, you can separately plan a PHP upgrade.

PHP’s official documentation provides current information about supported PHP versions, while MySQL’s documentation explains reliable database dump and restore methods for moving databases between machines. (php.net (dev.mysql.com)

After the new PHP website has been tested, update DNS and monitor the new server carefully. Keep the old server and backups available until you are confident that the migration is successful.

By following this guide, beginners can understand How to Migrate a PHP Website to a New Server and safely move PHP applications between hosting providers, VPS servers, development environments, and production servers.