Documenting new environment change

Author: lonnieezell

public/index.php

@@ -31,7 +31,7 @@
 }
 else
 {
-	define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');
+	define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'production');
 }
 
 /*

user_guide_src/source/general/environments.rst

@@ -6,19 +6,41 @@ Developers often desire different system behavior depending on whether
 an application is running in a development or production environment.
 For example, verbose error output is something that would be useful
 while developing an application, but it may also pose a security issue
-when "live".
+when "live". In development environments, you might want additional
+tools loaded that you don't in production environments, etc.
 
 The ENVIRONMENT Constant
 ========================
 
 By default, CodeIgniter comes with the environment constant set to use
 the value provided in ``$_SERVER['CI_ENV']``, otherwise defaulting to
-'development'. At the top of index.php, you will see::
+'production'. At the top of index.php, you will see::
 
 	define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');
 
 This server variable can be set in your ``.htaccess`` file, or Apache
 config using `SetEnv <https://httpd.apache.org/docs/2.2/mod/mod_env.html#setenv>`_.
+::
+
+    SetEnv CI_ENV development
+
+Under nginx, you must pass the environment variable through the ``fastcgi_params``
+in order for it to show up under the `$_SERVER` variable. This allows it to work on the
+virtual-host level, instead of using `env` to set it for the entire server, though that
+would work fine on a dedicated server. You would then modify your server config to something
+like::
+
+	server {
+	    server_name localhost;
+	    include     conf/defaults.conf;
+	    root        /var/www;
+
+	    location    ~* "\.php$" {
+	        fastcgi_param CI_ENV "production";
+	        include conf/fastcgi-php.conf;
+	    }
+	}
+
 Alternative methods are available for nginx and other servers, or you can
 remove this logic entirely and set the constant based on the server's IP address
 (for instance).
@@ -27,6 +49,20 @@ In addition to affecting some basic framework behavior (see the next
 section), you may use this constant in your own development to
 differentiate between which environment you are running in.
 
+Boot Files
+----------
+
+CodeIgniter requires that a PHP script matching the environment's name is located
+under **APPPATH/Config/Boot**. These files can contain any customizations that
+you would like to make for your environment, whether it's updating the error display
+settings, loading addtional developer tools, or anything else. These are
+automatically loaded by the system. The following files are already created in
+a fresh install:
+
+* development.php
+* production.php
+* testing.php
+
 Effects On Default Framework Behavior
 =====================================