Permalink
Browse files

Added readme and sample EE config and database files

  • Loading branch information...
1 parent 9b62010 commit 0c155fb429c14247cd6a374e68562144bbf24138 @erikreagan erikreagan committed Oct 25, 2011
Showing with 220 additions and 0 deletions.
  1. +163 −0 readme.textile
  2. +38 −0 system/expressionengine/config/config.php
  3. +19 −0 system/expressionengine/config/database.php
View
@@ -0,0 +1,163 @@
+h1. Focus Lab LLC's EE Master Config
+
+The purpose of this repository is to share our quick multi-environment setup for ExpressionEngine 2. We use this on every EE project to quickly and easily get support for multiple servers setup. This enables us to deploy any of our sites to any server with minimal changes or updates to any code or settings.
+
+
+h2. Introduction
+
+At Focus Lab we work in multiple environments for every ExpressionEngine site we build. (For the sake of simplicity we'll just define an environment as "any server running an instance of your site.") In order for ExpressionEngine to support quick and easy deployments across environments, you need to use a robust config file. This is our approach to doing just that.
+
+The folder structure for a given project is as such:
+
+<pre>/config
+ - config.{env}.php
+ - config.env.php
+ - config.master.php
+/public_html
+/system</pre>
+
+Where @{env}@ is a shorthand hand for our environment. We typically have 4 environments. Production, Staging, Shared development & Local development. That in mind, our files are as such:
+
+<pre>config.dev.php
+config.env.php
+config.local.php
+config.master.php
+config.prod.php
+config.stage.php</pre>
+
+
+h2. Concept
+
+There are three primary pieces to this structure. Environment declaration, master config values & environment-specific config values.
+
+
+h3. Environment Declaration
+
+This file is the starting point of your environment setup. Based on the @HTTP_HOST@ variable in PHP we define the environment (this may change if you're using a load balance environment or EE's MSM module). This is handled in the @config.env.php@ file.
+
+We approach the environment from the top down. We define all environments based on the domain and then set our default to "local" which allows our local developers to use whatever domain they choose (eg: mysite.dev, mysite.local, etc).
+
+Three constants are defined in our environment declaration file. They are:
+
+* @ENV@
+* @ENV_FULL@
+* @ENV_DEBUG@
+
+*@ENV@*
+
+This is the short-hand name of your environment. It needs to directly reflect the naming convention of your environment-specific file (seen below) such as @config.local.php@. This value is used as a conditional occasionally in the master config file.
+
+*@ENV_FULL@*
+
+This is the full name of your environment. There are no requirements on this value. We simply use it in our templates from time to time ("You are currently in the _Staging_ environment").
+
+*@ENV_DEBUG@*
+
+This is our boolean debug flag used frequently in our master config file. It allows us to keep debug settings "on" in specific environments. You can see how this is used in the master config file.
+
+h3. Master Config file
+
+Our @config.master.php@ file contains the bulk of the data for our setup. These are default configuration settings for our EE projects. Here we break up config settings into logical groups and add/remove as needed per project. In plain English, this is what the @config.master.php@ document does/says:
+
+<pre>If EE is looking for database credentials
+ Load our environment-specific file (eg: config.prod.php)
+ Define our DB cache directory
+ Merge our expressionengine/config/database.php array with our environment-specific db array
+ Unset our environment-specific array now that it's been used as needed
+End if
+
+If EE is looking for config array values
+ Define our base paths (as inspired by Matt Weinberg)
+ Define our template config settings
+ Define our Debug settings
+ Define our Performance-impacting settings
+ Define any 3rd party settings
+ Define any member-specific settings
+ Define some final, miscellaneous settings
+ Load our environment-specific config file (eg: config.prod.php)
+ Setup some global variables for template use: {global:env} and {global:env_full}
+ Merge our Global Variables arrays then our Config arrays
+End if</pre>
+
+*Override Options*
+
+You can find a list of available configuration override options here on the EE Wiki page "EE 2 Config Overrides":http://expressionengine.com/wiki/EE_2_Config_Overrides. You can alternatively find individual setting array keys by "inspecting" elements within EE's Control Panel and taking note of the input names. Third party developers may also include config override support in their add-ons.
+
+*Global Variables*
+
+You can define a set of template global variables in the @config.master.php@ file as well. Around line @220@ you will see that there are 2 variables available as an example. You can add anything here that you prefer, such as default date format strings etc.
+
+
+h3. Environment-Specific Config
+
+The final piece to the equation is the environment-specific file. This file include the database credentials and any desired config overrides or global variables. This is the simplest and shortest of the three files.
+
+There are three possible arrays to use here. They are @$env_db@, @env_config@ and @$env_global@.
+
+*@$env_db@*
+
+This is just for your database credentials for the environment.
+
+<pre><code>$env_db['hostname'] = '';
+$env_db['username'] = '';
+$env_db['password'] = '';
+$env_db['database'] = '';</code></pre>
+
+*@$env_config@*
+
+This array allows you to override any config value from EE or from the master config file. This is useful for changing things that may be unique to a test environment. A good example would be the *webmaster_email* setting. If a single developer wants to receive all system emails to themselves when developing locally, they might use the following:
+
+<pre><code>$env_config['webmaster_email'] = 'me@domain.com';</code></pre>
+
+*@$env_global@*
+
+This array is for defining global variables available within your EE templates. An example of how this can be used is the idea of using Google Analytics (GA) to track stats on your site. In the past we've used GA for tracking Staging and Production environments separately. Doing this was simple because we could define the GA key per-environment as needed.
+
+<pre><code>$env_global['global:google_analytics'] = 'UA-XXXXXXX-XX';</code></pre>
+
+This gives you variables like @{global:google_analytics}@ in your EE templates.
+
+
+h2. Setup
+
+* Copy the @/config@ directory to the same directory level as your @system@ directory (we recommend "above web root":http://expressionengine.com/user_guide/installation/best_practices.html#moving-the-system-directory-above-webroot)
+* Modify @config.env.php@ to reflect your environments and domains. You can remove and add environments as needed
+* Update each @config.{env}.php@ file with each environment's database credentials as needed
+* Create config overrides and global variables for each environment as needed
+* Add the following code to the bottom of @system/expressionengine/config/config.php@:
+
+<pre><code>/**
+ * Require the Focus Lab, LLC Master Config file
+ */
+require $_SERVER['DOCUMENT_ROOT'] . '/../config/config.master.php';
+
+
+/* End of file config.php */
+/* Location: ./system/expressionengine/config/config.php */</code></pre>
+
+* Replace the contents of your @system/expressionengine/config/database.php@ file with the contents in of the same file in this repository
+
+
+h2. Contributions
+
+If you're interested in making this better please feel free to "fork":http://help.github.com/fork-a-repo/ the code "on GitHub":https://github.com/focuslabllc/ee-master-config and send "pull requests":http://help.github.com/send-pull-requests/. Also, we'd love to track any potential issues through the repository's "Issues tracker":https://github.com/focuslabllc/ee-master-config/issues.
+
+
+h2. Support
+
+We are happy to answer questions as needed and able, but there is no official support for using this config setup. Use it at your own risk with the understanding that our responses to any inquires will fall behind any commitments we may have at the time.
+
+*We are also available for private consultation if you would like assistance getting this setup for your EE site.*
+
+dev@focuslabllc.com
+
+
+h2. Legal
+
+h3. Disclaimer Of Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF QUALITY, PERFORMANCE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, NEWISM PTY LTD. DOES NOT WARRANT THAT THE SOFTWARE OR ANY RELATED SERVICE WILL ALWAYS BE AVAILABLE.
+
+h3. Limitations Of Liability
+
+YOU ASSUME ALL RISK ASSOCIATED WITH THE INSTALLATION AND USE OF THE SOFTWARE. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS OF THE SOFTWARE BE LIABLE FOR CLAIMS, DAMAGES OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE. LICENSE HOLDERS ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USE AND ASSUME ALL RISKS ASSOCIATED WITH ITS USE, INCLUDING BUT NOT LIMITED TO THE RISKS OF PROGRAM ERRORS, DAMAGE TO EQUIPMENT, LOSS OF DATA OR SOFTWARE PROGRAMS, OR UNAVAILABILITY OR INTERRUPTION OF OPERATIONS.
@@ -0,0 +1,38 @@
+<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
+
+/*
+|--------------------------------------------------------------------------
+| ExpressionEngine Config Items
+|--------------------------------------------------------------------------
+|
+| The following items are for use with ExpressionEngine. The rest of
+| the config items are for use with CodeIgniter, some of which are not
+| observed by ExpressionEngine, e.g. 'permitted_uri_chars'
+|
+*/
+
+$config['app_version'] = '2xx';
+$config['install_lock'] = '';
+$config['license_number'] = 'xxxx-xxxx-xxxx-xxxx';
+$config['doc_url'] = 'http://expressionengine.com/user_guide/';
+$config['site_label'] = 'Your Company';
+// END EE config items
+
+
+
+// ---------------------------------------------------------------
+// Numerous CodeIgniter config settings go here. We've removed
+// them for breviety in our repository code example
+//
+// The config values start with "base_url" and go to "proxy_ips"
+// ---------------------------------------------------------------
+
+
+
+/**
+ * Require the Focus Lab, LLC Master Config file
+ */
+require $_SERVER['DOCUMENT_ROOT'] . '/../config/config.master.php';
+
+/* End of file config.php */
+/* Location: ./system/expressionengine/config/config.php */
@@ -0,0 +1,19 @@
+<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
+
+$active_group = 'expressionengine';
+$active_record = TRUE;
+
+$db['expressionengine']['dbdriver'] = 'mysql';
+$db['expressionengine']['dbprefix'] = 'exp_';
+$db['expressionengine']['pconnect'] = FALSE;
+$db['expressionengine']['swap_pre'] = 'exp_';
+$db['expressionengine']['db_debug'] = TRUE;
+$db['expressionengine']['cache_on'] = FALSE;
+$db['expressionengine']['autoinit'] = FALSE;
+$db['expressionengine']['char_set'] = 'utf8';
+$db['expressionengine']['dbcollat'] = 'utf8_general_ci';
+
+require $_SERVER['DOCUMENT_ROOT'] . '/../config/config.master.php';
+
+/* End of file database.php */
+/* Location: ./system/expressionengine/config/database.php */

0 comments on commit 0c155fb

Please sign in to comment.