hexanet/settings-bundle

settings system

SettingsBundle

, _(*1)

Settings system., _(*2)

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:, _(*3)

$ composer require hexanet/settings-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:, _(*4)

$ composer require hexanet/settings-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation., _(*5)

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:, _(*6)

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Hexanet\SettingsBundle\HexanetSettingsBundle(),
        );

        // ...
    }

    // ...
}

Database

You have to create the table in the database, to do this we generate a migration:, _(*7)

bin/console doctrine:migrations:diff --filter-expression="/setting$/"
bin/console doctrine:migrations:migrate

Usage

Define the settings

A schema allows you to initialize the settings by giving them a default value., _(*8)

First you need to create a class that extends from the SchemaInterface interface:, _(*9)

<?php

namespace App\Settings\AppSchema;

use Hexanet\SettingsBundle\Schema\SettingsBuilder;
use Hexanet\SettingsBundle\Schema\SchemaInterface;

class AppSchema implements SchemaInterface
{
    public function build(SettingsBuilder $settingsBuilder): void
    {
        $settingsBuilder->addSetting('itemsPerPage', 25);
    }
}

Then declare it as service with the hexanet.settings_schema tag :, _(*10)

App\Settings\AppSchema:
    tags: [hexanet.settings_schema]

The bundle provide autoconfiguration for class that implement SchemaInterface., _(*11)

After that we can use the php bin/console hexanet:settings:setup command to generate all the settings, if a setting already exists the command ignores it., _(*12)

Examples

public function indexAction(SettinsManagerInterface $settingsManager) {
    // set and get
    $settingsManager->set('tva', 19.6);
    $settingsManager->get('tva');

    // check if settign exists
    $settingsManager->has('tva');

    // get all settings
    $settingsManager->all();

    // retrieve a non-existent setting 
    $settingsManager->get('not here');
    //  SettingNotFoundException is throw
}

Production

For production it's possible to activate the cache by modifying the config of the bundle:, _(*13)

// config/packages/prod/hexanet_settings.yaml
hexanet_settings:
    cache: true

The Symfony cache app is used (@cache.app), _(*14)

Credits

Developed by Hexanet., _(*15)

License

SettingsBundle is licensed under the MIT license., _(*16)