oallain/settings-bundle

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

2.0.1 2018-10-28 18:05 UTC

Requires

• php: ^5.5.9|^7.0
• doctrine/orm: ^2.2.3
• psr/cache: ^1.0
• symfony/form: ^2.7|^3.0|^4.0
• symfony/framework-bundle: ^2.7|^3.0|^4.0

Requires (Dev)

• doctrine/doctrine-bundle: ~1.2
• matthiasnoback/symfony-dependency-injection-test: ^0.7
• mockery/mockery: ^0.9
• phpunit/phpunit: ^4.6
• polishsymfonycommunity/symfony-mocker-container: ^1.0

Suggests

• cache/adapter-bundle: This bundle will help you to add your PSR-6 cache implementations as Symfony services

MIT

• Dmitriy Scherbina
• Tobias Nyholm
• Richard van Laak

• symfony
• configuration
• bundle
• config
• Settings

README

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

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

Symfony controller:

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

// User settings
$this->get('settings_manager')->get('name', $user); // returns global 'foo'
$this->get('settings_manager')->set('name', 'bar', $user);
$this->get('settings_manager')->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 documentation for more examples.

Documentation

• Installation
• General usage
• Scopes
• Advanced configuration
• I18n
• Customization
• FAQ

Changelog, Roadmap and contribution

Please, do not hesitate to report bugs or send pull requests. It will help to motivate me to support library better than anything else :)

See CHANGELOG.md for all major changes.

Upgrade from 1.0.*

Make sure to read the UPGRADE.md to successfully migrate your application.

License

The MIT License. For the full text of license, please, see LICENSE