add php.env for loading $_ENV config

.gitignore

@@ -1,5 +1,8 @@
 # Composer directory
 vendor/
 
+# $_ENV config overloading
+.env
+
 # This is a library
 composer.lock

README.md

@@ -11,9 +11,27 @@ composer install --dev
 phpunit --bootstrap=vendor/autoload.php tests
 ```
 
-to set the database host, user, or password:
+The default database connection details are:
+
+- hostname: localhost
+- database: ohanzee
+- username: ohanzee
+- password: (empty)
+
+These values can be modified by creating a `.env` file in the root of the project:
+
+```ini
+PHPUNIT_TEST_HOSTNAME=server
+PHPUNIT_TEST_DATABASE=testing
+PHPUNIT_TEST_USERNAME=jane
+PHPUNIT_TEST_PASSWORD=likesblue
+```
+
+The `.env` file is a standard ini file and will be loaded using [dotenv](https://github.com/vlucas/phpdotenv).
+
+Any of the parameters can also be passed directly on the commandline:
 
 ```
-PHPUNIT_TEST_HOSTNAME=myhostname PHPUNIT_TEST_USERNAME=bob PHPUNIT_TEST_PASSWORD=secret \
+PHPUNIT_TEST_USERNAME=joe PHPUNIT_TEST_PASSWORD=likesgreen \
   phpunit --bootstrap=vendor/autoload.php tests
 ```

composer.json

@@ -47,5 +47,6 @@
     },
     "require-dev": {
         "phpunit/phpunit": "4.2.*"
+        "vlucas/phpdotenv": "~1.0"
     }
 }

tests/Database/MysqliTest.php

@@ -2,13 +2,18 @@
 
 class MysqliTest extends PHPUnit_Framework_TestCase
 {
+    public function setUp()
+    {
+        Dotenv::load(realpath(__DIR__ . '/../../'));
+    }
+
     private function getEnvConfig()
     {
         $config = [
-            'hostname' => @$_ENV['PHPUNIT_TEST_HOSTNAME'],
-            'database' => @$_ENV['PHPUNIT_TEST_DATABASE'],
-            'username' => @$_ENV['PHPUNIT_TEST_USERNAME'],
-            'password' => @$_ENV['PHPUNIT_TEST_PASSWORD'],
+            'hostname' => getenv('PHPUNIT_TEST_HOSTNAME'),
+            'database' => getenv('PHPUNIT_TEST_DATABASE'),
+            'username' => getenv('PHPUNIT_TEST_USERNAME'),
+            'password' => getenv('PHPUNIT_TEST_PASSWORD'),
         ];
 
         return array_filter($config);