1 <?php

     2 

     3 /**

     4  * @file

     5  * Configuration file for Drupal's multi-site directory aliasing feature.

     6  *

     7  * This file allows you to define a set of aliases that map hostnames, ports, and

     8  * pathnames to configuration directories in the sites directory. These aliases

     9  * are loaded prior to scanning for directories, and they are exempt from the

    10  * normal discovery rules. See default.settings.php to view how Drupal discovers

    11  * the configuration directory when no alias is found.

    12  *

    13  * Aliases are useful on development servers, where the domain name may not be

    14  * the same as the domain of the live server. Since Drupal stores file paths in

    15  * the database (files, system table, etc.) this will ensure the paths are

    16  * correct when the site is deployed to a live server.

    17  *

    18  * To use this file, copy and rename it such that its path plus filename is

    19  * 'sites/sites.php'. If you don't need to use multi-site directory aliasing,

    20  * then you can safely ignore this file, and Drupal will ignore it too.

    21  *

    22  * Aliases are defined in an associative array named $sites. The array is

    23  * written in the format: '<port>.<domain>.<path>' => 'directory'. As an

    24  * example, to map http://www.drupal.org:8080/mysite/test to the configuration

    25  * directory sites/example.com, the array should be defined as:

    26  * @code

    27  * $sites = array(

    28  *   '8080.www.drupal.org.mysite.test' => 'example.com',

    29  * );

    30  * @endcode

    31  * The URL, http://www.drupal.org:8080/mysite/test/, could be a symbolic link or

    32  * an Apache Alias directive that points to the Drupal root containing

    33  * index.php. An alias could also be created for a subdomain. See the

    34  * @link http://drupal.org/documentation/install online Drupal installation guide @endlink

    35  * for more information on setting up domains, subdomains, and subdirectories.

    36  *

    37  * The following examples look for a site configuration in sites/example.com:

    38  * @code

    39  * URL: http://dev.drupal.org

    40  * $sites['dev.drupal.org'] = 'example.com';

    41  *

    42  * URL: http://localhost/example

    43  * $sites['localhost.example'] = 'example.com';

    44  *

    45  * URL: http://localhost:8080/example

    46  * $sites['8080.localhost.example'] = 'example.com';

    47  *

    48  * URL: http://www.drupal.org:8080/mysite/test/

    49  * $sites['8080.www.drupal.org.mysite.test'] = 'example.com';

    50  * @endcode

    51  *

    52  * @see default.settings.php

    53  * @see conf_path()

    54  * @see http://drupal.org/documentation/install/multi-site

    55  */