mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
77476de917
The _ss_environment.php file can now be in any parent folder of the framework (according to realpath()) Removing the description of '3 levels deep' and replaced with explanation of infinite depth.
103 lines
4.7 KiB
Markdown
103 lines
4.7 KiB
Markdown
# Environment management
|
|
|
|
As website developers, we noticed that we had a few problems. You may have the same problems:
|
|
|
|
* On our development laptops, we have a number of sites, but the database connection details are the same for each of
|
|
them. Why should we have to go through the installation process and re-enter them each time?
|
|
* Each of those sites needed to be in development mode when we were editing them on our laptops, but in production mode
|
|
when we deploy them to our servers. Additionally, our production host's database connection details will likely be
|
|
different than our local server.
|
|
|
|
SilverStripe comes with a solution to this: the `_ss_environment.php` file. You can put a single `_ss_environment.php`
|
|
file in your "projects" folder on your development box, and it will be used by each of your development sites.
|
|
|
|
## Setting up your development machine with _ss_environment.php
|
|
|
|
In this example, we assume that you are managing multiple projects as subfolders of `~/Sites/`, and that you can visit
|
|
these at `http://localhost/`. For example, you might have a project at `~/Sites/myproject/`, and visit it at
|
|
`http://localhost/myproject/`.
|
|
|
|
Create a new file, `~/Sites/_ss_environment.php`. Put the following content in it, editing the values of the
|
|
"SS_DATABASE_..." and "SS_DEFAULT_ADMIN_..." defines as appropriate.
|
|
|
|
:::php
|
|
<?php
|
|
/* What kind of environment is this: development, test, or live (ie, production)? */
|
|
define('SS_ENVIRONMENT_TYPE', 'dev/test/live');
|
|
|
|
/* Database connection */
|
|
define('SS_DATABASE_SERVER', 'localhost');
|
|
define('SS_DATABASE_USERNAME', 'root');
|
|
define('SS_DATABASE_PASSWORD', '');
|
|
|
|
/* Configure a default username and password to access the CMS on all sites in this environment. */
|
|
define('SS_DEFAULT_ADMIN_USERNAME', 'username');
|
|
define('SS_DEFAULT_ADMIN_PASSWORD', 'password');
|
|
|
|
|
|
Now, edit each of your site's configuration file, `~/Sites/(projectname)/mysite/_config.php`. Delete all mention
|
|
of `$databaseConfig` and `Director::set_dev_servers`, and instead make sure that you file starts like this.
|
|
|
|
:::php
|
|
<?php
|
|
|
|
global $project;
|
|
$project = 'mysite';
|
|
|
|
global $database;
|
|
$database = '(databasename)';
|
|
|
|
// Use _ss_environment.php file for configuration
|
|
require_once("conf/ConfigureFromEnv.php");
|
|
|
|
|
|
## How it works
|
|
|
|
The mechanism by which the `_ss_environment.php` files work is quite simple. Here's how it works:
|
|
|
|
* At the beginning of SilverStripe's execution, the `_ss_environment.php` file is searched for, and if it is found, it's
|
|
included. SilverStripe looks in all the parent folders of framework up to the server root (using the REAL location of
|
|
the dir - see PHP realpath()):
|
|
* The `_ss_environment.php` file sets a number of "define()".
|
|
* "conf/ConfigureFromEnv.php" is included from within your `mysite/_config.php`. This file has a number of regular
|
|
configuration commands that use those defines as their arguments. If you are curious, open up
|
|
`framework/conf/ConfigureFromEnv.php` and see for yourself!
|
|
|
|
### An Example
|
|
|
|
This is my `_ss_environment.php` file. I have it placed in `/var`, as each of the sites are in a subfolder of `/var`.
|
|
|
|
:::php
|
|
<?php
|
|
// These three defines set the database connection details.
|
|
define('SS_DATABASE_SERVER', 'localhost');
|
|
define('SS_DATABASE_USERNAME', 'root');
|
|
define('SS_DATABASE_PASSWORD', '<password>');
|
|
|
|
// This sets a prefix, which is prepended to the $database variable. This is
|
|
// helpful mainly on shared hosts, when every database has a prefix.
|
|
define('SS_DATABASE_PREFIX', 'simon_');
|
|
|
|
// These two lines are a bit complicated. If I'm connecting to the server from
|
|
// 127.0.0.1 or MyIP and I'm using a browser with a + in the UserAgent, the site
|
|
// is put in dev mode, otherwise it is put in live mode. Most sites would only
|
|
// need to put the site in either dev or live mode, thus wont need the IP checks
|
|
if(isset($_SERVER['REMOTE_ADDR']) && ($_SERVER['REMOTE_ADDR'] == '127.0.0.1' || ($_SERVER['REMOTE_ADDR'] == '<MyIP>'
|
|
&& strpos($_SERVER['HTTP_USER_AGENT'], '+') !== false)))
|
|
define('SS_ENVIRONMENT_TYPE', 'dev');
|
|
else
|
|
define('SS_ENVIRONMENT_TYPE', 'live');
|
|
|
|
// These two defines sets a default login which, when used, will always log
|
|
// you in as an admin, even creating one if none exist.
|
|
define('SS_DEFAULT_ADMIN_USERNAME', '<email>');
|
|
define('SS_DEFAULT_ADMIN_PASSWORD', '<password>');
|
|
|
|
// This causes errors to be written to the silverstripe.log file in the same directory as this file, so /var.
|
|
// Before PHP 5.3.0, you'll need to use dirname(__FILE__) instead of __DIR__
|
|
define('SS_ERROR_LOG', __DIR__ . '/silverstripe.log');
|
|
|
|
// This is used by sake to know which directory points to which URL
|
|
global $_FILE_TO_URL_MAPPING;
|
|
$_FILE_TO_URL_MAPPING['/var/www'] = 'http://simon.geek.nz';
|