PHPackages                             outerweb/settings - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. outerweb/settings

ActiveLibrary[Database & ORM](/categories/database)

outerweb/settings
=================

Application wide settings stored in your database

v2.0.3(2mo ago)4899.2k↑11.9%10[4 PRs](https://github.com/outer-web/settings/pulls)4MITPHPPHP ^8.4CI passing

Since Feb 11Pushed 1mo agoCompare

[ Source](https://github.com/outer-web/settings)[ Packagist](https://packagist.org/packages/outerweb/settings)[ Docs](https://github.com/outer-web/settings)[ GitHub Sponsors](https://github.com/Outerweb)[ RSS](/packages/outerweb-settings/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (28)Versions (13)Used By (4)

[![Settings](./docs/images/github-banner.png)](./docs/images/github-banner.png)

Settings
========

[](#settings)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a817c08a2af9a8d7682d87fc4d4329c1bab1b5473a04ce455e3deda699b88146/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f757465727765622f73657474696e67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/outerweb/settings)[![GitHub Tests Action Status](https://camo.githubusercontent.com/d986059bdb2e1ac23d6e49d0fe358201b39c418ea4e30de93c200c4d6a9f6d88/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f757465727765622f73657474696e67732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/outer-web/settings/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/979c2e5834059a80419a774a8441b903f84145d9ed0eb9adf5232074d6c13e20/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f757465727765622f73657474696e67732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/outer-web/settings/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/64a6ff09f89384acc3487b3830a6bc71bf11ad29370bdbd59da0e1c89971b88a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f757465727765622f73657474696e67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/outerweb/settings)

This package provides application wide settings stored in your database

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Usage](#usage)
- [Changelog](#changelog)
- [License](#license)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require outerweb/settings
```

Run the install command to publish the migration and the config file:

```
php artisan settings:install
```

Usage
-----

[](#usage)

This package tries to mimic the Config functionality of Laravel as close as possible.

You can use the `Outerweb\Settings\Facades\Setting` facade or the `setting()` helper function to work with your stored settings.

### Storing settings

[](#storing-settings)

#### Storing a single setting

[](#storing-a-single-setting)

```
use Outerweb\Settings\Facades\Setting;

Setting::set('key', 'value');
// or
setting(['key' => 'value']);
// or
setting()->set('key', 'value');
```

#### Storing multiple settings

[](#storing-multiple-settings)

```
use Outerweb\Settings\Facades\Setting;

Setting::set([
    'key1' => 'value1',
    'key2' => 'value2',
]);
// or
setting([
    'key1' => 'value1',
    'key2' => 'value2',
]);
// or
setting()->set([
    'key1' => 'value1',
    'key2' => 'value2',
]);
```

#### Storing nested settings

[](#storing-nested-settings)

You can use "dot" notation to store nested settings:

```
use Outerweb\Settings\Facades\Setting;

Setting::set('parent.child', 'value');
// or
setting(['parent.child' => 'value']);
// or
setting()->set('parent.child', 'value');
```

This will store a single table entry with the key `parent.child` and the value `value`.

You can also store nested settings using arrays:

```
use Outerweb\Settings\Facades\Setting;

Setting::set([
    'parent' => [
        'child1' => 'value',
        'child2' => 'value',
    ],
]);
// or
setting([
    'parent' => [
        'child1' => 'value',
        'child2' => 'value',
    ],
]);
// or
setting()->set([
    'parent' => [
        'child1' => 'value',
        'child2' => 'value',
    ],
]);
```

This will store two table entries:

- `parent.child1` with the value `value`
- `parent.child2` with the value `value`

### Retrieving settings

[](#retrieving-settings)

#### Retrieving a single setting

[](#retrieving-a-single-setting)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::get('key');
// or
$value = setting('key');
// or
$value = setting()->get('key');
```

This will return the value of the setting stored with the key `key`. If the setting does not exist, it will return `null`.

You can also provide a default value that will be returned if the setting does not exist:

```
$value = Setting::get('key', 'default_value');
// or
$value = setting('key', 'default_value');
// or
$value = setting()->get('key', 'default_value');
```

This will return `default_value` if the setting with the key `key` is null or does not exist.

#### Retrieving a nested setting

[](#retrieving-a-nested-setting)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::get('parent.child');
// or
$value = setting('parent.child');
// or
$value = setting()->get('parent.child');
```

This will return the value of the setting stored with the key `parent.child`.

#### Retrieving multiple settings via parent key

[](#retrieving-multiple-settings-via-parent-key)

Imagine you have the following settings stored:

- `parent.child1` with the value `value1`
- `parent.child2` with the value `value2`

```
use Outerweb\Settings\Facades\Setting;

$values = Setting::get('parent');
// or
$values = setting('parent');
// or
$values = setting()->get('parent');
```

This will return an associative array:

```
[
    'child1' => 'value1',
    'child2' => 'value2',
]
```

#### Retrieving multiple settings

[](#retrieving-multiple-settings)

```
use Outerweb\Settings\Facades\Setting;

$values = Setting::get(['parent.child1', 'parent.child2']);
// or
$values = setting(['parent.child1', 'parent.child2']);
// or
$values = setting()->get(['parent.child1', 'parent.child2']);
```

This will return an associative array:

```
[
    'parent.child1' => 'value1',
    'parent.child2' => 'value2',
]
```

#### Retrieving all settings

[](#retrieving-all-settings)

```
use Outerweb\Settings\Facades\Setting;

$values = Setting::get();
// or
$values = setting()->get();
```

This will return all settings as an associative array.

### Type safety

[](#type-safety)

You can use the following methods to ensure type safety when retrieving settings:

#### String

[](#string)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::string('key');
// or
$value = setting()->string('key');
```

This will make sure the returned value is a string. Otherwise, it will throw an `UnexpectedValueException`.

#### Integer

[](#integer)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::integer('key');
// or
$value = setting()->integer('key');
```

This will make sure the returned value is an integer. Otherwise, it will throw an `UnexpectedValueException`.

#### Float

[](#float)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::float('key');
// or
$value = setting()->float('key');
```

This will make sure the returned value is a float. Otherwise, it will throw an `UnexpectedValueException`.

#### Boolean

[](#boolean)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::boolean('key');
// or
$value = setting()->boolean('key');
```

This will make sure the returned value is a boolean. Otherwise, it will throw an `UnexpectedValueException`.

#### Array

[](#array)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::array('key');
// or
$value = setting()->array('key');
```

This will make sure the returned value is an array. Otherwise, it will throw an `UnexpectedValueException`.

#### Collection

[](#collection)

```
use Outerweb\Settings\Facades\Setting;

$value = Setting::collection('key');
// or
$value = setting()->collection('key');
```

This uses the same logic as `array()` but returns a `Illuminate\Support\Collection` instance instead of an array.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance89

Actively maintained with recent releases

Popularity46

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 60% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~95 days

Total

9

Last Release

62d ago

Major Versions

v1.1.0 → v2.0.02025-10-08

PHP version history (2 changes)v1.0.0PHP ^8.0

v2.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/d5a072b1191f02ac21a84af067a579b6f3323da7e45197369a7540f98c152407?d=identicon)[outerweb.be](/maintainers/outerweb.be)

---

Top Contributors

[![SimonBroekaert](https://avatars.githubusercontent.com/u/35606498?v=4)](https://github.com/SimonBroekaert "SimonBroekaert (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laravelSettingsOuterweb

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/outerweb-settings/health.svg)

```
[![Health](https://phpackages.com/badges/outerweb-settings/health.svg)](https://phpackages.com/packages/outerweb-settings)
```

###  Alternatives

[dyrynda/laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

4802.8M8](/packages/dyrynda-laravel-model-uuid)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

423715.4k1](/packages/clickbar-laravel-magellan)[watson/validating

Eloquent model validating trait.

9723.3M47](/packages/watson-validating)[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[reedware/laravel-relation-joins

Adds the ability to join on a relationship by name.

2121.2M13](/packages/reedware-laravel-relation-joins)[jerome/filterable

Streamline dynamic Eloquent query filtering with seamless API request integration and advanced caching strategies.

19226.1k](/packages/jerome-filterable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)