edvinaskrucas / settings
Persistent settings package for Laravel framework.
Installs: 80 473
Dependents: 1
Suggesters: 0
Security: 0
Stars: 227
Watchers: 6
Forks: 34
Open Issues: 9
Requires
- php: ^5.5|^7.0
- illuminate/console: ^5.2
- illuminate/database: ^5.2
- illuminate/filesystem: ^5.2
- illuminate/support: ^5.2
Requires (Dev)
- mockery/mockery: 0.9.*
README
Package is looking for maintainers Please contact me if interested.
Persistent Settings for Laravel 5
Persistent settings package for Laravel 5.
- Driver support
- Cache settings via laravel cache
- Encrypt / Decrypt setting values
- Fire events after action
- Override config values
- Helper function
- Settings by context
- Serialize values
Installation
Require this package in your composer.json:
"require": {
"edvinaskrucas/settings": "2.0.0"
}
Version matrix
Registering to use it with laravel
Add following lines to app/config/app.php
ServiceProvider array
Krucas\Settings\Providers\SettingsServiceProvider::class,
Alias array
'Settings' => Krucas\Settings\Facades\Settings::class
Publishing config file
If you want to edit default config file, just publish it to your app folder.
php artisan vendor:publish --provider="Krucas\Settings\Providers\SettingsServiceProvider" --tag="config"
Usage
Configuration
Package comes with several configuration options.
Creating table for database driver
To use database driver you have to create table in your database. Package provides default table migration, to create it you need to execute artisan command:
$ php artisan settings:table
Methods
Set value
Set setting value.
Settings::set($key, $value = null);
Get value
Get setting value, default value is returned when no value found.
Settings::get($key, $default = null);
Check value
Determine if setting exists.
Settings::has($key);
Forget value
Forget setting value from repository.
Settings::forget($key);
Set context
Setting values may be used in certain context. Context can be set using method context()
.
Settings::context(new Context(['user' => 1]));
Context is reset after call of one these methods set
, get
, has
, forget
.
Example how to use settings for different contexts.
$userContext1 = new Context(['user' => 1]); $userContext2 = new Context(['user' => 2]); Settings::context($userContext1)->set('key', 'value1'); Settings::context($userContext2)->set('key', 'value2'); // retrieve settings $userValue1 = Settings::context($userContext1)->get('key'); // value1 $userValue2 = Settings::context($userContext2)->get('key'); // value2
Helpers
Settings service instance
Resolve settings service instance.
settings();
Set value
Set setting value.
settings([$key => $value]);
Set setting value for a context.
settings([$key => $value], new Context(['user' => 1]));
Get value
Get setting value, default value is returned when no value found.
settings($key, $default = null);
Getting value for a context.
settings($key, $default, new Context(['user' => 1]));
Events
Events gets fired if this is not disabled via config (enabled by default).
settings.checking: $key
Fired before checking if value is present in repository.
settings.has: $key
Fired after checking if value is present in repository.
settings.getting: $key
Fired before retrieving value from repository.
settings.get: $key
Fired after retrieving value from repository.
settings.setting: $key
Fired before setting value to repository.
settings.set: $key
Fired after setting value to repository.
settings.forgetting: $key
Fired before forgetting value.
settings.forget: $key
Fired after forgetting value.