Best way to store a PHP App's Settings?

What is the best approach to storing a group of global settings for a custom PHP application? I am working on a personal project (first major one really), and need a method o开发者_运维百科f storing key-value pairs for recording overall settings for the application.

Things to store as...

• Website's Global Name.
• Theme (just a variable, or path to theme)
• etc

Should I just keep them in one table? If so what is the best way to query them from a boostrap? Besides doing a single query for each desired setting.

UPDATE: Yes a .ini or parsing an include file would be nice, and I know how to do it that way. But I wanted to know what would be the best approach to storing them in MySQL with everything else.

UPDATE2: The reason I ask this also is I plan for a lot of these settings to be changeable through the Administrator interface. So if you were to change the Title of the site, it would be updated right away, which I figured would be best to do through SQL, thus needing setting inside the DB.

For a single, small, simple site, I'd just put config in a PHP file. Keep it simple. PHP probably doesn't parse anything faster than it parses PHP. If you use APC, the compiled bytecode is even cached -- although the bytecode is then re-executed for every request. For a small config file, this bytecode execution should take very little time; for a very large file, it might take a bit longer.

For high-traffic sites with large configs, caching your config data in APC (e.g. as a single array) is a good idea -- at the very least, you save the overhead of actually executing the statements in your config.php file. Notably, facebook does this. When you're serving many requests per second, hitting the disk to read a config file (using parse_ini_file, an XML parser, etc.) on every request is out of the question.

For my current project, we host many sites, each with their own config. Each site had both a database and a config file; however, making sure you're always using the right config file with the right database can become a headache. Additionally, changes would require changing things in two places -- the db and the config. Forgetting one or the other always caused problems, and it happened far too frequently.

We moved the config into the database, so that you can't possibly separate a db from it's correct config, and any code changes only require updating the database. The data from the config table is also aggressively cached in APC, so we query it rarely.

So, to recap:

1. Small site: just use a config.php file
2. Very large site: cache in APC
3. Multiple sites: store config in database to reduce administration overhead; cache in APC to reduce database hits

Have you thought about putting them in a .php file and including it on the pages you need to use them? Give the variables a unique name so avoid naming conflicts.

Since you'll be using them repeatedly in your PHP application, this would be most ideal. This also avoids the need to make database calls if you were to store them in a database.

AppSettings.php

<?php
$_SITENAME_ = 'MyWebsite';
$_THEME_ = 'Theme/Path';
?>

UPDATE:

I assume you want these settings to be editable via a web page and don't want multiple DB Queries since these settings will change, but not too often?

One approach I personally took was to serialize the AppSettings table and store it in a XML file. Of course, every time the table is updated, the table would be reserialized and stored in the XML file. Then I created a separate class that parses the XML file and returns the specific values I needed.

We just use

$siteConfig['db_name'] = 'database1';
$siteConfig['site_name'] = 'Stackoverflow';

In a included php file. Putting the values in a array helps with name conflicts.

i understand you want to keep things in a mysql table, however, that likely means storing required configuration in multiple places. for example, i'm sure you'll want the database server and name stored in a string somewhere. that means putting those in an include or .ini file since you can't read them from a database (how can you connect to the database without knowing those things). so, you'd be keeping the db connection info in an include or .ini file and the rest of the settings in the database? that works, i suppose, but i like to keep all of the settings in one file (config.php or application.ini or whatever). it makes it easier to maintain imo.

-don

Just got done chatting with a few people on IRC about this. I looked at how Wordpress handled this after I pulled up a SQL dump of one copy. I think I'll use this layout and rename the columns a bit. But the idea is...

option_id | option_name | option_value | autoload
int       | varchar     | longtext     | varchar
(PRIMARY) | (UNIQUE)    |              |

I liked Microsoft.Net's web.config ConfigurationManager.appSettings and how that worked. So I mimicked it and kinda made it better. It

• Works in any environment without having to swap files (which I always forget, especially when deploying on Friday at 4:59 p.m.)
• Is self documenting on what the function call is
• Can handle global settings with *

  <?php

    namespace Library {

    // the config depends on the environment, and the environment depends on the website url
    class Configuration {

        private static $environment;
        public static function GetEnvironment(){
            if(empty(Configuration::$environment)){
                // returns 'dev' or 'prod'
                switch($_SERVER['SERVER_NAME']){
                    case 'innitech.com':
                        Configuration::$environment = 'prod';
                    default:
                        Configuration::$environment = 'dev';
                }
            }
            return Configuration::$environment;
        }

        private const settings = [
            "dev" => [
                'dbserver'          => 'localhost',
                'database'          => 'mydb',
                'dbuser'            => 'myuser',       
                'dbpassword'        => 'mypass',       
                'dbdebug'           => false,
                'trace'             => true
            ],
            'prod' => [
                'dbserver'          => 'sql1.innitech.com',       
                'database'          => 'blahinc',
                'dbuser'            => 'proddb',
                'dbpassword'        => 'ButIWasToldiDgETaStApLer',
            ],
            '*' => [
                'adminemail'        => 'admins@innitech.com',
                'adminphone'        => '123456789',
                'dbdebug'           => false,
                'trace'             => false
            ]
        ];

        public static function Setting($name){
            return  self::setting[self::GetEnvironment()][$name] ?? 
                    self::setting['*'][$name];
        }

    }
    }
    ?>

Usage

$conn = new mysqli(Configuration::Setting('dbserver'), Configuration::Setting('dbuser'), Configuration::Setting('dbpassword'), Configuration::Setting('database'));

What has mentioned before, is true. I like the one more than the other, but I mostly use another way of storing my configuration.

I never use a database as the place to store my settings, because that would create a lot of data transfers, which can make the application a little more insecure- in my opinion. Besides, some application hosts (like Amazon's AWS and Google's Cloud Platform) limit the read/write actions to a database.

Therefore, I mostly use this method:

Firstly, I create a file config/settings.php with the following contents:

<?php
return [
    'database' => [
        'host' => 'localhost',
        'port' => 3006,
        'user' => 'username',
        'password' => // your secret password
    ],
    'application' => [
        'name' => 'Your site\'s name',
        'version' => '1.0-dev'
    ]
]

When you want to use this in you index.php file, add the following line in it:

$config = include('./config/settings.php');

I hope this can add some information for you or others.

I generally within my index.php file set up the "required" settings so:

<?php
session_start();
ob_start();

define('BASEPATH', $_SERVER['DOCUMENT_ROOT'].'/_setUp/siteSetup/');      // CHANGE TO THE PATH OF THE SITE.
define('URIPATH', 'http://localhost/_setUp/siteSetup/');                // CHANGE TO THE URL OF THE SITE.
define ('DEBUGGER', true);                                              // CHANGE TO FALSE TO HIDE DEBUG MESSAGES
include(BASEPATH.'system/lib/config.lib.php');
?>

and within my config file:

<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');

// public

/* 
example:
    <img src="<?php echo IMG ?>my_image.jpg">
    http://localhost/public/images/
    <img src="http://localhost/public/images/my_image.jpg">
*/
define('CSS', URIPATH.'public/css/');                   // DEFINE DIR: css
define('IMG', URIPATH.'public/images/');                // DEFINE DIR: images   
define('JS', URIPATH.'public/scripts/');                // DEFINE DIR: scripts

// system
define('INC', BASEPATH.'system/includes/');             // DEFINE DIR: includes
define('LIB', BASEPATH.'system/lib/');                  // DEFINE DIR: lib
define('SQL', BASEPATH.'system/sql/');                  // DEFINE DIR: sql

if (DEBUGGER) {
    ini_set('log_errors',TRUE);
    ini_set("error_log", BASEPATH.'system/'."error_log.txt");
}
else {
    ini_set('log_errors',TRUE);
    ini_set("error_log", BASEPATH.'system/'."error_log.txt");
}

$db_info = array(
    'host' => 'localhost',
    'username' => 'root',
    'password' => 'root',
    'database' => 'my_db'
);


/*
to use:
    $db_info = unserialize(DB_INFO);
    echo $db_info['host'];
    echo $db_info['username'];
    echo $db_info['password'];
    echo $db_info['database'];
*/
define('DB_INFO', serialize($db_info));
?>

A decent approach would be to fetch commonly used settings once per page, via database. Something like keeping a autoload bool field that checks whether the setting should be loaded with the page. For other, much less commonly fetched settings, you can fetch them over the air.

If you decide to cache them all instead of fetching for every page, you might want to think of a way to notify the script to reload the settings -- or you'd have to manually tell it to do so, so you wouldn't get stuck with old settings after changing some.

I'm working with a system that does store its settings in the database.

My advice in short: Do not do it!

Storing the settings in the database means, whenever we have to move the database, e.g. from production to development, we also have to update all the settings, or the dev system might start sending e-mails (did happen--made front-page news...) or interact with production systems (also happened--saved by backups...)

So, no, never store the configuration in the database!

When you store the settings in a file, local to the environment (dev, test, prod) you can move the database around at your leisure, always assured the settings will be picked up from the file in the respective environment.

Update: Giving it some more thought I'd probably go for a combination of a table (non-lethal information without server info or integration info or anything else that will kill you if it isn't environment specific) and a .ini-file (or several).

The rule would be that a key in a .ini-file would always override anything stored in the table (to prevent above disasters, maybe even make that key "read-only" from any UI).

If you want to get extra fancy you might even add value types; boolean represented as a checkbox, dates with a date selector, even select boxes with separated option values, and of course ints that would have to be numbers even if the table might store them as strings.

Then I'd look into using some form of memory-based caching if reading the settings got slow.