bonk007/system-settings

Dynamic settings for application

v1.1.0 2025-03-05 16:39 UTC

Requires

• php: ^8.1|^8.2
• laravel/framework: ^10.0|^11.0|^12.0

Requires (Dev)

• phpunit/phpunit: ^10.0|^11.0

MIT

• Ayi Muhammad Iqbal Nasuha

• php
• laravel
• system-settings

README

1. Install
2. How to
   • Set Value
   • Get Value
   • Remove Value
3. Configurable Model
   • How to Define
   • How it works
4. Accepted Value

Install

Install the package using composer

composer require bonk007/system-settings

then run migration

php artisan migrate

that's all ⚡

How to

Set setting's value

settings()->set('<group>.<key>', <value>);

example

settings()->set('global-settings.maintenance_scheduled_at', Carbon::parse('2024-07-01 00:00:00'));

if you need to set some value for specific configurable model (learn: what is configurable model)

settings()->for(<model instance>)
  ->set('<group>.<key>', <value>);

example

settings()->for(\App\Models\Organization::find(6))
  ->set('invoice.number_format', 'INV/{SEQUENCE}/{MONTH}/{YEAR}');

or you can use

settings()->set('<group>.<key>.<table of configurable model>.<primary key>', <value>);

example

settings()->set('invoice.number_format.organizations.6', 'INV/{SEQUENCE}/{MONTH}/{YEAR}');

Get setting's value

settings('<group>.<key>', <default value>);

for specific configurable model

settings()->for(<configurable model>)
  ->get('<group>.<key>', <default value>);

or using simple way

settings('<group>.<key>.<table of configurable model>.<primary key>', <default value>)

example

settings('global-settings.maintenance_scheduled_at');
settings('invoice.number_format.organizations.6');
settings()->for(\App\Models\Organization::find(6))
  ->get('invoice.number_format');

Remove setting

settings->unset('<group>.<key>')

with specific configurable model

settings->unset('<group>.<key>.<table of configurable model>.<primary key>')

or

settings()->for(<configurable model>)
  ->unset('<group>.<key>');

example

settings()->unset('global-settings.maintenance_scheduled_at');
settings()->unset('invoice.number_format.organizations.6');
settings()->for(\App\Models\Organization::find(6))
  ->unset('invoice.number_format');

Configurable Model

Configurable model is a Eloquent Model represents an instance that owns custom configurations value.

How to define

Model should implement \Settings\Configurable::class interface example

class User extends Model implements Configurable
{
  // ...
}

Be careful, using shortcut settings()->set('<group>.<key>.<table of configurable model>.<primary key>', <value>);, there is possibility you will store non-configurable model into settings table, then you can't use settings()->for(\App\Models\Organization::find(6)) for any function.

How it works

Configurable model will be stored as polymorphic relation at settings table. The field columns are configurable_table and configurable_id. By default configurable_id has unsigned bigint type, but you can change the type by define static variable \Settings\Manager::$configurableMorphType value with uuid|int|string at AppServiceProvider before you run artisan migrate.

class AppServiceProvider extends ServiceProvider
{
  public function register()
  {
    // ...
    \Settings\Manager::$configurableMorphType = 'uuid';
  }
}

Accepted Value

• string
• boolean
• double/float
• integer
• array
• \DatetimeInterface
• Eloquent Model
• Model Collection
• Basic Collection