gaaarfild/laravel-conf

Store additional configs in JSON or Database (write, read)

Laravel Improved Config

, _(*1)

, _(*2)

Russian Documentation / Русская документация, _(*3)

Custom editable configs for Laravel 5., _(*4)

Caution

Repository address changed from gaaarfild to garf. Dont forget to fix your composer.json., _(*5)

This package helps you to store your additional configuration from your code in custom storage., _(*6)

By default it uses JSON-file., _(*7)

This is helpful when you need to edit your configuration by user from GUI. i.e. Website settings., _(*8)

Caution!

Be careful! This is version 2 of the package and fallback configuration was removed., _(*9)

If you still need to use it, please install version 1.*, _(*10)

Install

To install version 2, type the following command in your command line:, _(*11)

``` BASH $ composer require "garf/laravel-conf:3.*", <sub>(*12)</sub>

Or add

``` JSON
"garf/laravel-conf": "3.*"

to your composer.json file into require section., <sub>(*13)</sub>

Then type in console, <sub>(*14)</sub>

``` BASH $ composer update, <sub>(*15)</sub>

When update completed, add to your `config/app.conf` file to `providers` section

``` PHP
'providers' => [
    // ...
    Garf\LaravelConf\LaravelConfServiceProvider::class,
]

If you want to use Conf facade, add to same file at the aliases section, <sub>(*16)</sub>

``` PHP 'aliases' => [ // ... 'Conf' => Garf\LaravelConf\ConfFacade::class, ], <sub>(*17)</sub>

### Publishing config file

To be able to change file location, please execute the following command in the console:

`php artisan vendor:publish --provider="Garf\LaravelConf\LaravelConfServiceProvider" --tag="config"`

Then you can edit file `config/laravel-conf.php` to set any path to file you want to.

## Usage

### Get config value

``` php
Conf::get('key.to.retrieve', 'default_value');

Else will return default value., <sub>(*18)</sub>

Could be used 'dot' notation, <sub>(*19)</sub>

Save config value

``` PHP Conf::set('key', 'value_to_save');, <sub>(*20)</sub>

Could be used 'dot' notation

Also method `put` can be used to store multiple config values as array

``` PHP
$config = [
    'key1' => 'value1',
    'key2.subkey' => `value2`,
];
Conf::put($config);

Removing key from config

``` PHP Conf::forget('key');, <sub>(*21)</sub>

Could be used 'dot' notation

### Get entire config

``` PHP
Conf::all();

Get entire config in JSON

``` PHP Conf::toJson();, <sub>(*22)</sub>

### Check config key existence

``` PHP
Conf::has('key.to.check');

Could be used 'dot' notation, <sub>(*23)</sub>

Helper

Also helper conf() can be used for more convenience., <sub>(*24)</sub>

Usage is similar to build in config() helper., <sub>(*25)</sub>

``` PHP conf()->set('key.subkey', 'myValue');, <sub>(*26)</sub>

conf('key.subkey') // will return 'myValue', <sub>(*27)</sub>

conf('non.existing.key', 'myDefaultValue') // will return 'myDefaultValue', <sub>(*28)</sub>

$config = [ 'key1' => 'value1', 'key2.subkey' => value2, ];, <sub>(*29)</sub>

conf($config), <sub>(*30)</sub>

## Custom storage drivers

This package uses the Laravel Manager class under the hood, so it's easy to add your own custom store driver if you want to store in some other way. All you need to do is extend the abstract `Garf\LaravelConf\Drivers\AbstractDriver` class, implement the abstract methods and call Conf::extend.

``` php
class MyStorageDriver extends Garf\LaravelConf\Drivers\AbstractDriver {
    // ...
}
Conf::extend('mystorage', function($app) {
    return $app->make('MyStorageDriver');
});

Contributions

Contributions are highly appreciated., <sub>(*31)</sub>

Send your pull requests to master branch., <sub>(*32)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*33)</sub>