corneltek/configkit

Fast config toolkit, which provides super lightweight config accessor and loader.

Monday, May 29, 2017
by c9s
Repository
2 Watchers
10 Stars
12,862 Installations

PHP
8 Dependents
0 Suggesters
1 Forks
2 Open issues
22 Versions
1 % Grown

The README.md

ConfigKit

, _(*1)

ConfigKit compiles your readable YAML config file to PHP files automatically., _(*2)

YAML format is clean, smart, easy. but in PHP, you have to parse yaml config file in every request. Parsing YAML costs too much CPU time. How to improve it ?, _(*3)

php-ConfigKit is a library for config files and which is designed for performance, it parses yaml config files for the first time, then compiles the config files into php files, so these config files can be cached in PHP, and it can also be in APC or any other cache backend system., _(*4)

ConfigKit is simple and fast, all you have to do is defining your config file in YAML format, then use ConfigKit to load the config file., _(*5)

ConfigKit uses static methods because static methods are faster than object methods., _(*6)

It checks if a {config file}.php exists, if so, then checks the file modification time to decide whether to recompile yaml files., _(*7)

When APC extension is enabled, PHP source code can be cached in APC, so when you require the pure php source file, it will be faster then reparsing it from yaml., _(*8)

A generated config PHP file is like:, _(*9)

<?php return array (
      'ApplicationName' => 'Phifty',
      'ApplicationID' => 'phifty',
      'ApplicationUUID' => '9fc933c0-70f9-11e1-9095-3c07541dfc0c',
      'Domain' => 'phifty.dev',

Requirement

YAML extension, _(*10)

Installation

Composer:, _(*11)

{
    "require": { 
        "corneltek/configkit": "~1.5"
    }
}

Usage

ConfigCompiler

To compile a yaml config file and get the config stash:, _(*12)

$config = ConfigCompiler::load('tests/ConfigKit/data/framework.yml');
print_r( $config );

To disable stats check (mtime checking):, _(*13)

ConfigCompiler::$statCheck = false;
$config = ConfigCompiler::load('tests/ConfigKit/data/framework.yml');

If you want to compile the config file manually, you may call the compile static function to do that:, _(*14)

$compiledFile = ConfigCompiler::compile('config/framework.yml');

You may also specify the compiled filename in the arguments:, _(*15)

$compiledFile = ConfigCompiler::compile('config/framework.yml', 'config/framework.php');

You can also override some config values during the compilation, by using the override_compile function:, _(*16)

$compiledFile = ConfigCompiler::override_compile('config/framework.yml', array( 
    'something_should_not_be_in_config_file' => 123123123,
    'something_should_not_be_in_git' => 123123123,
    'something_generated_in_the_runtime' => random(),
));

To test if a compiled file needs to be updated (re-compile):, _(*17)

if ( ConfigCompiler::test('config/framework.yml','config/framework.php')) ) {
    ConfigCompiler::compile(....);
} else {
    // already up to date.
}

ConfigLoader

You can manage multiple config files with ConfigLoader, _(*18)

$loader = new ConfigLoader;
$loader->load( 'framework', 'config/framework.yml' );
$loader->load( 'database', 'config/database.yml' );

To get config stash, _(*19)

$paths = $loader->get('framework','web.paths');
$templates = $loader->get('framework','web.templates');
foreach( $paths as $path ) {
    echo $path, "\n";
}

To write all config stash into one cache file:, _(*20)

$loader->writeStashes('all.php');

To load all config stash back:, _(*21)

$loader->loadStashes('all.php');

Generate AppConfigLoader class

$loader = new ConfigKit\ConfigLoader;
$loader->load('database','tests/data/database.yml');
$loader->load('framework','tests/data/framework.yml');
$appClass = $loader->generateAppClass('MyApp\\AppConfigLoader');
$path = $appClass->generatePsr4ClassUnder('tests');
require_once($path); 
$appConfigLoader = new \MyApp\AppConfigLoader;

The Versions

29/05 2017

dev-master

9999999-dev

Fast config toolkit, which provides super lightweight config accessor and loader.

library configkit

Fast config toolkit, which provides super lightweight config accessor and loader.

corneltek/configkit

The README.md

ConfigKit

Requirement

Installation

Usage

ConfigCompiler

ConfigLoader

Generate AppConfigLoader class

The Versions

dev-master

The Requires

The Development Requires

1.6.6

The Requires

The Development Requires

1.6.5

The Requires

The Development Requires

1.6.4

The Requires

The Development Requires

1.6.3

The Requires

The Development Requires

1.6.2

The Requires

The Development Requires

1.6.1

The Requires

The Development Requires

1.6.0

The Requires

The Development Requires

1.5.5

The Requires

The Development Requires

1.5.4

The Requires

The Development Requires

1.5.3

The Requires

The Development Requires

1.5.2

The Requires

The Development Requires

1.5.1

The Requires

The Development Requires

1.5.0

The Requires

The Development Requires

1.4.2

The Requires

The Development Requires

1.4.1

The Requires

The Development Requires

1.4.0

The Requires

The Development Requires

1.3.4

The Requires

The Development Requires

1.3.3

The Requires

The Development Requires

1.3.2

The Requires

The Development Requires

1.3.1

The Requires

The Development Requires

1.3.0

The Requires

The Development Requires