PHPackages                             martinambroz/settings-bundle - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. martinambroz/settings-bundle

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

martinambroz/settings-bundle
============================

Database centric Symfony configuration management. Global and per-user settings supported.

3.x-dev(2y ago)010MITPHPPHP ^7.2|^8.0

Since Jan 12Pushed 2y agoCompare

[ Source](https://github.com/martinambroz/SettingsBundle)[ Packagist](https://packagist.org/packages/martinambroz/settings-bundle)[ Docs](https://github.com/dmishh/SettingsBundle)[ RSS](/packages/martinambroz-settings-bundle/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelogDependencies (13)Versions (2)Used By (0)

SettingsBundle
==============

[](#settingsbundle)

Bundle for storing configuration with Symfony in database using Doctrine ORM.

👀 This bundle was previously known as `dmissh/settings-bundle`, and the Packagist installation instruction will stay as is.

Features
--------

[](#features)

- Easy-to-use (Twig extension, container service)
- Settings scopes per user, global or all
- Settings validation by using the Symfony Form Component
- 2 serialization mechanisms: PHP `serialize()` and JSON (+ you can write your own)
- Settings caching (PSR-6)
- Fast and extensible

Quick usage examples
--------------------

[](#quick-usage-examples)

Symfony controller:

```
// Global settings
$settingsManager->set('name', 'foo');
$settingsManager->get('name'); // returns 'foo'

// User settings
$settingsManager->get('name', $user); // returns global 'foo'
$settingsManager->set('name', 'bar', $user);
$settingsManager->get('name', $user); // returns 'bar'
```

Twig template:

```
{# Global setting #}
{{ get_setting('some_setting') }} {# => 'value' #}

{# User setting #}
{{ get_setting('some_user_setting', app.user) }} {# => 'value' #}
```

See the [general usage](/Resources/doc/general-usage.md) documentation for more examples.

Documentation
-------------

[](#documentation)

- [Installation](/Resources/doc/installation.md)
- [General usage](/Resources/doc/general-usage.md)
- [Scopes](/Resources/doc/scopes.md)
- [Advanced configuration](/Resources/doc/advanced-configuration.md)
- [I18n](/Resources/doc/i18n.md)
- [Customization](/Resources/doc/customization.md)
- [FAQ](/Resources/doc/faq.md)

Changelog, Roadmap and contribution
-----------------------------------

[](#changelog-roadmap-and-contribution)

Please, do not hesitate to [report bugs](https://github.com/dmishh/SettingsBundle/issues) or send [pull requests](https://github.com/dmishh/SettingsBundle/pulls). It will help to motivate me to support library better than anything else :)

See [CHANGELOG.md](CHANGELOG.md) for all major changes.

### Upgrade from 1.0.\*

[](#upgrade-from-10)

Make sure to read the [UPGRADE.md](UPGRADE.md) to successfully migrate your application.

License
-------

[](#license)

The MIT License. For the full text of license, please, see [LICENSE](/LICENSE)

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~55 days

Total

2

Last Release

800d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c8f06bf27e60290f7c09bc26c28767efb080f788b73fff783fa350c29bae2c45?d=identicon)[martinambroz](/maintainers/martinambroz)

---

Top Contributors

[![dmishh](https://avatars.githubusercontent.com/u/822562?v=4)](https://github.com/dmishh "dmishh (88 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (64 commits)")[![rvanlaak](https://avatars.githubusercontent.com/u/2707563?v=4)](https://github.com/rvanlaak "rvanlaak (40 commits)")[![nikophil](https://avatars.githubusercontent.com/u/10139766?v=4)](https://github.com/nikophil "nikophil (4 commits)")[![jonny-no1](https://avatars.githubusercontent.com/u/282458?v=4)](https://github.com/jonny-no1 "jonny-no1 (3 commits)")[![martinambroz](https://avatars.githubusercontent.com/u/8005739?v=4)](https://github.com/martinambroz "martinambroz (3 commits)")[![jongotlin](https://avatars.githubusercontent.com/u/165154?v=4)](https://github.com/jongotlin "jongotlin (1 commits)")[![Alexandre-T](https://avatars.githubusercontent.com/u/5101481?v=4)](https://github.com/Alexandre-T "Alexandre-T (1 commits)")[![jphilaine](https://avatars.githubusercontent.com/u/707933?v=4)](https://github.com/jphilaine "jphilaine (1 commits)")[![Koc](https://avatars.githubusercontent.com/u/191082?v=4)](https://github.com/Koc "Koc (1 commits)")[![aminin](https://avatars.githubusercontent.com/u/329494?v=4)](https://github.com/aminin "aminin (1 commits)")[![fautor](https://avatars.githubusercontent.com/u/21367624?v=4)](https://github.com/fautor "fautor (1 commits)")[![Atyz](https://avatars.githubusercontent.com/u/1155066?v=4)](https://github.com/Atyz "Atyz (1 commits)")[![hason](https://avatars.githubusercontent.com/u/288535?v=4)](https://github.com/hason "hason (1 commits)")

---

Tags

symfonybundleconfigurationSettingsconfig

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[dmishh/settings-bundle

Database centric Symfony configuration management. Global and per-user settings supported.

115254.9k1](/packages/dmishh-settings-bundle)[lexik/translation-bundle

This bundle allows to import translation files content into the database and provide a GUI to edit translations.

4362.7M19](/packages/lexik-translation-bundle)[jbtronics/settings-bundle

A symfony bundle to easily create typesafe, user-configurable settings for symfony applications

9546.7k2](/packages/jbtronics-settings-bundle)[opensky/runtime-config-bundle

This bundle provides a way to inject parameters into services at runtime by exposing a RuntimeParameterBag service, which functions exactly like Symfony2's own ParameterBags.

10949.5k1](/packages/opensky-runtime-config-bundle)[glooby/task-bundle

Scheduling of tasks for symfony made simple

3216.3k](/packages/glooby-task-bundle)

PHPackages © 2026

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