jwyuen/configee-php

Configee: A dead simple config manager for php

Configee for PHP!

What is it?

A php library that you can add to any project to help you manage application specific php config files, such as database connection parameters. For example, if you were creating a PHP framework, you'd want anyone using your project to be able to define their own config parameters for connecting to their own database., _(*1)

What is the purpose?

The purpose is to have a dead simple interface for setting and getting configuration parameters by only having to define config files., _(*2)

Install

Just add to your composer.json like:, _(*3)

{
  "require": {
    "jwyuen/configee-php": "1.1"
  }
}

Usage

Instantiate the main class wherever you need to use your configuration parameters, such as a bootstrap file., _(*4)

$configee = new \Configee\Configee('your/config/path');
$config = $configee->getConfig();

Config Parsing Structure

Configee can handle an n-deep directory structure if you so choose to nest your configs like so. The only requirement is that your config files are php files and return an array., _(*5)

For example, consider the following directory structure:, _(*6)

configroot
\- db
 |- mysql.php
 \- AnEmptyFolder
\-general.php

Contents of mysql.php:, _(*7)

<?php

return array(
  'host' => 'localhost',
  'user' => 'amysqluser',
  'password' => 'apassword',
);

Contents of general.php, _(*8)

<?php

return array(
  'use_cookies' => true,
  'aconfigoption' => 1,
);

Given the above, you'll get a config structure like so:, _(*9)

array(
  "db" => array(
    "mysql" => array(
      "host" => "localhost",
      "user" => "amysqluser",
      "password" => "apassword"
    )
  ),
  "general" => array(
    "use_cookies" => true,
    "aconfigoption" => 1
  )
)

Important PSA

If you decide to store sensitive credentials in your config(s), make sure to set proper permissions on them to make sure not just anyone can look at them! E.g., _(*10)

chmod 640 <your-config-file>