How To Create Test Environment For Shopware 6

It is recommended to apply changes to the test environment of your Shopware 6 website before implementing them on a working e-commerce store. As a result, you ensure that everything runs as expected without interfering with the live system. In the following article, we shed light on creating a test environment for Shopware 6. You will learn how to generate it in the secondary directory of your live shop. Alternatively, it is possible to create a local test environment described below. You can find more Shopware 6 tutorials in our cookbook. Let’s explore how to create a Shopware 6 test environment.

Note that we provide Shopware integration with external platforms. Contact our support for further information or try our Improved Import, Export & Mass Actions.

Get Improved Import, Export & Mass Actions for Shopware by Firebear Studio

Explore Shopware 

Secondary Directory 

The most simple and intuitive way to create a test environment for Shopware 6 is to copy your live shop into a secondary directory. Next, you can access the public folder in this directory through a hoster’s subdomain.

While copying the test environment to a subdirectory of the main Shopware 5 shop was usual, Shopware 6 is associated with a slightly diverse approach. The latest platform’s version differs a lot from its predecessor. Therefore, it is recommended to choose a secondary directory instead of a subdirectory. Thus, you ensure that the Shopware 6 test environment works correctly. Let’s explore the steps necessary to mirror the live shop into a secondary directory.

Copy the live system

Follow these steps to copy your live Shopware 6 system, creating its test environment:

1. Create a new folder next to the main store directory;
2. Name it (e.g., testshop);
3. Copy the files of your live environment into this folder;
4. Ensure that you also copied the .env and .htaccess files.
   Since their names start with “.”, they may not be displayed directly – adjust the display settings to see them.

Create a subdomain

During this step, it is necessary to work with your hoster to create a Shopware 6 test environment. Take the following actions:

1. Create a subdomain of your main domain, such as https://my-shop.subdomain.eu;
2. Route this domain to the newly created folder. 

Note that creating a subdomain that differs from the shop domain is necessary. Otherwise, the latter will be linked to the test environment.

Create a database

Next, create a database to implement a test environment for Shopware 6. Follow these steps:

1. Use phpMyAdmin or similar software to create a new, empty database for your Shopware 6 test environment;
2. Open the database overview via the New (1) item. Alternatively, you can use the Databases tab;
3. Enter a name (2) of your test database;
4. Choose the “utf8mb4_unicode_ci” collation (3) from the dropdown. 

In this example, the database is called “testshop“.

Change the .env file

Now, you need to edit the .env file situated in the root directory of your Shopware 6 test environment. It should be linked to the newly created database:

1. Open the .env file;
2. Find the line that begins with DATABASE_URL= 
   1. You can see the database-related information after “=”;
   2. The name of the utilized database is situated after “/”. You need to specify the name of the new database here, as shown below:
      
      
      DATABASE_URL=mysql://user:passwort@localhost:3306/testshop

      1	DATABASE_URL=mysql://user:passwort@localhost:3306/testshop

3. Now, adjust the APP_URL entry to store the complete call for the test shop there, as shown below:
   
   
   APP_URL=http://my-shop.com/testshop/public

   1	APP_URL=http://my-shop.com/testshop/public

4. Note that you may also need to adjust the entry under COMPOSER_HOME if the path stored there leads to your Shopware directory.
   If you locate the Composer outside of the Shopware installation, there is no need to edit COMPOSER_HOME.

Copy the live database

At this stage, you need to copy the contents of your live database to the newly created test database to create a test environment for Shopware 6. You can use phpMyAdmin. This software is often used for similar purposes since it offers import/export functionality.

Follow these steps to export a database in Shopware 6:

1. Choose the database of the live shop (1);
2. Proceed to the Export tab (2);
3. Click Go (3);
4. phpMyAdmin creates an SQL file with the name of your live database (“liveshop.sql” in our example) necessary for your Shopware 6 test environment.

Now, you need to import this file to the database of your test environment.

Follow these steps to do that:

• Choose the newly created database of your test instance (1);
• Proceed to the Import tab (2);
• Hit the Browse button (3) and select the exported file (“liveshop.sql” in our example); 
• Hit the Go button (4) to initiate the import process and create a Shopware 6 test environment. 

It may take some time to run the import process, depending on the size of the live database.

Some extensions may store APP_URL in the database with the URL of the Shopware installation, but the latter doesn’t match the URL of the test environment. As a result, you are notified that the shop domain has been changed. Reinstalling the apps usually addresses this issue, automatically adjusting the corresponding entry. 

Also, it is necessary to keep in mind that some extensions incorporate subscription plans. Therefore, you should consult their manufacturers regarding avoiding situations when the database copy leads to double billing.

Customize the sales channel domain

Now adjust the sales channel domain in admin to create a test environment for Shopware 6:

1. Reach the admin under https://my-shop.subdomain.com/admin;
2. Choose the sales channel (1) in the main menu.
3. Proceed to the domain section and adjust the URL of your sales channel (2).
   1. Add a /testshop at the end to make the test shop accessible and create your new Shopware 6 test environment;
4. Save the change and access your storefront at https://my-shop.subdomain.com.

Local test environment

Now, let’s see how to locally create a test environment for Shopware 6. Since plugins work correctly only when the test environment is accessed with the domain stored in the Shopware account, you need to perform some extra steps described below.

Also, the test environment should be able to reach the Shopware license server to perform the license comparison. And it is good to provide a stable Internet connection to get support if necessary.

Create a hosts entry

You need to create a host entry to access the Shopware 6 test environment from your computer under the URL that is stored in the Shopware account. 

In the following example, we use the “my-shop.com” domain. The test environment is available under the following IP address: 192.168.0.123. Also, pay attention to whether the domain is deposited in the Shopware account with or without “www”. 

Windows

The hosts file in Windows is located in the following directory:

Enter the IP address of the Shopware 6 test environment along with the license domain to this file as follows:

Linux (Ubuntu)

As for Ubuntu, the hosts file is also located in the /etc/ directory. Enter the IP address of the test environment along with the license domain to this file as follows:

Note that the # lines are desirable for IPv6 capable hosts.

macOS

For macOS, the directory of the hosts file is the same. You can edit it via the terminal. Use the following command:

Enter the IP address of the Shopware 6 test environment along with the license domain to this file at a random position in a separate line:

Call the local environment

Now, when you’ve adapted the hosts file on your computer, it is possible to access the local environment via the live shop domain.

If your Shopware 6 local test environment can communicate with the Internet, the purchased plugins can also be used there.

It is also worth mentioning that while the hosts entry is stored for the local test environment, it is impossible to reach the live shop from your computer via URL.

Shopware 6 Essentials FAQ

Get Improved Import & Export for Shopware by Firebear Studio

Explore Shopware