Multiple websites or stores (MAGE_RUN_TYPE, MAGE_RUN_CODE)

Contents

• Introduction to multiple Magento stores and websites
• Configure Magento
• Set values for MAGE_RUN_TYPE and MAGE_RUN_CODE

Introduction to multiple Magento stores and websites

One instance of the Magento software can enable you to start multiple websites or store views that use different:

• Default languages
• Domain names
• Categories

This flexible solution enables one Magento codebase and Magento Admin to administer and display different stores.

You configure the websites, stores, and store views in the Magento Admin. You use the MAGE_RUN_TYPE and MAGE_RUN_CODE variables in entry point scripts or .htaccess files to start the Magento application using these websites or store views.

A typical use of MAGE_RUN_TYPE and MAGE_RUN_CODE is to set up stores with different options in different domains. For example, you could have one set of categories and products on one domain and another domain that has categories and products for a different language.

Configure Magento websites and stores

This section discusses the minimum tasks required to use the MAGE_RUN_TYPE and MAGE_RUN_CODE variables.

We use the following terms:

• Website is the top-level container for sites, shipping methods, payment methods, and so on. To create completely separate sites that do not share cart, shipping methods, and so on, you must create separate websites.

• Store is contained by a website. In turn, a store contains at least one store view.

  Multiple stores can share cart, user sessions, payment gateways, and so on, but they have separate catalog structures.

  Store views change the way pages are presented, and are typically used to display a store with different layouts or languages.

Each website and each store view must have a unique identifier. This identifier is required to use MAGE_RUN_TYPE and MAGE_RUN_CODE.

To create websites and stores:

1. Log in to the Magento Admin as a user authorized to create websites, stores, and store views.
2. Click Stores > All Stores.
3. To create a website, click Create Website.
4. To create a store, click Create Store.
5. To create a store view, click Create Store View.
6. When you create your website or store view, make note of its unique identifier because you’ll use it later.

Set values for MAGE_RUN_TYPE and MAGE_RUN_CODE

The following sections discuss alternatives for setting values for MAGE_RUN_TYPE and MAGE_RUN_CODE:

• Set values in an entry point script
• Set values in .htaccess

Set values in an entry point script

If necessary, copy the existing index.php entry point script for your website or store view and add to it the following:

<?php
 $params = $_SERVER;
 $params[\Magento\Store\Model\StoreManager::PARAM_RUN_CODE] = '<code>';
 $params[\Magento\Store\Model\StoreManager::PARAM_RUN_TYPE] = '{store|website}';
 $bootstrap = \Magento\Framework\App\Bootstrap::create(BP, $params);
 $app = $bootstrap->createApplication('Magento\Framework\App\Http');
 $bootstrap->run($app);
 ?>

Sample index.php snippet that starts Magento with a website with the code frenchsite.example.com:

<?php
 $params = $_SERVER;
 $params[\Magento\Store\Model\StoreManager::PARAM_RUN_CODE] = 'frenchsite.example.com';
 $params[\Magento\Store\Model\StoreManager::PARAM_RUN_TYPE] = 'website';
 $bootstrap = \Magento\Framework\App\Bootstrap::create(BP, $params);
 $app = $bootstrap->createApplication('Magento\Framework\App\Http');
 $bootstrap->run($app);
 ?>

Set values in .htaccess

This section discusses how to set values for MAGE_RUN_TYPE and MAGE_RUN_CODE using Apache server variables SetEnvIf or RewriteCond. If you’re not sure what environment variable to use, consult a network administrator.

For more information about SetEnvIf or RewriteCond, see:

• Apache 2.2: SetEnvIf, RewriteCond
• Apache 2.4: SetEnvIf, RewriteCond

SetEnvIf example

Add the following after RewriteEngine on in .htaccess:

SetEnvIf Host .*<your domain>.* MAGE_RUN_CODE=<code>
SetEnvIf Host .*<your domain>.* MAGE_RUN_TYPE={store|website}

For example, to use a website with the code frenchsite.example.com:

SetEnvIf Host .*example.com.* MAGE_RUN_CODE=frenchsite.example.com
SetEnvIf Host .*example.com.* MAGE_RUN_TYPE=website

RewriteCond example

Add code similar to the following after RewriteBase /magento/ in .htaccess:

RewriteCond %{HTTP_HOST} ^(.*)<your domain>\<domain suffix>
RewriteRule .* – [E=MAGE_RUN_CODE:<code>]
RewriteCond %{HTTP_HOST} ^(.*)<your domain>\<domain suffix>
RewriteRule .* – [E=MAGE_RUN_TYPE:{store|website}]

For example, to use a website with the code frenchsite.example.com:

RewriteCond %{HTTP_HOST} ^(.*)example\.com
RewriteRule .* – [E=MAGE_RUN_CODE:frenchsite.example.com]
RewriteCond %{HTTP_HOST} ^(.*)example\.com
RewriteRule .* – [E=MAGE_RUN_TYPE:website]