knplabs/dictionary-bundle

Are you often tired to repeat static choices like gender or civility in your apps ?

Monday, April 30, 2018
by Knplabs
Repository
23 Watchers
43 Stars
73,988 Installations

PHP
1 Dependents
0 Suggesters
13 Forks
2 Open issues
28 Versions
3 % Grown

The README.md

DictionaryBundle

, _(*1)

Are you often tired to repeat static choices like gender or civility in your apps ?, _(*2)

Requirements

PHP >= 8.1
Symfony 5.4, 6.4 or 7.*

Installation

Run the following command:, _(*3)

composer require knplabs/dictionary-bundle

$bundles = array(
    // ...
    Knp\DictionaryBundle\KnpDictionaryBundle::class => ['all' => true],
);

Maintainers

You can ping us if need some reviews/comments/help:, _(*5)

Basic usage

Define dictionaries in your config.yml file:, _(*6)

knp_dictionary:
  dictionaries:
    my_dictionary: # your dictionary name
      - Foo        # your dictionary content
      - Bar
      - Baz

You will be able to retreive it by injecting the Collection service and accessing the dictionary by its key, _(*7)


    private Dictionary $myDictionary;
    public function __construct(
        \Knp\DictionaryBundle\Dictionary\Collection $dictionaries)
    {
        $this->myDictionary = $dictionaries['my_dictionary'];
    }

Dictionary form type

Now, use them in your forms:, _(*8)

use Knp\DictionaryBundle\Form\Type\DictionaryType;

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder
        ->add('civility', DictionaryType::class, array(
            'name' => 'my_dictionary'
        ))
    ;
}

The dictionary form type extends the symfony's choice type and its options., _(*9)

Validation constraint

You can also use the constraint for validation. The value has to be set., _(*10)

use Knp\DictionaryBundle\Validator\Constraints\Dictionary;

class User
{
    /**
     * @ORM\Column
     * @Dictionary(name="my_dictionary")
     */
    private $civility;
}

Advanced usage

You can specify the indexation mode of each dictionary, _(*11)

knp_dictionary:
  dictionaries:
    my_dictionary:      # your dictionary name
      type: 'key_value' # your dictionary type
      content:          # your dictionary content
        "foo": "foo_value"
        "bar": "bar_value"
        "baz": "baz_value"

Available types

value (default) : Natural indexation
value_as_key: Keys are defined from their value
key_value: Define your own keys
callable: Build a dictionary from a callable

Callable dictionary

You can create a callable dictionary:, _(*12)

knp_dictionary:
  dictionaries:
    my_callable_dictionary:     # your dictionary name
      type: 'callable'          # your dictionary type
      service: 'app.service.id' # a valid service from your application
      method: 'getSomething'    # the method name to execute

Callable dictionaries are loaded with a lazy strategy. It means that the callable will not be called if you do not use the dictionary., _(*13)

Iterator based dictionary

You can create a dictionary from an iterator:, _(*14)

knp_dictionary:
  dictionaries:
    my_iterator_dictionary:     # your dictionary name
      type: 'iterator'          # your dictionary type
      service: 'app.service.id' # a valid service from your application

Iterator based dictionaries are loaded with a lazy strategy. It means that the iterator will not be fetched if you do not use the dictionary., _(*15)

Combined dictionary

You can combine multiple dictionaries into a single one:, _(*16)

knp_dictionary:
  dictionaries:
    payment_mode:
      type: key_value
      content:
        card: "credit card"
        none: "none"

    extra_payment_mode:
      type: key_value
      content:
        bank_transfer: "Bank transfer"
        other: "Other"

    combined_payment_mode:
      type: combined
      dictionaries:
        - payment_mode
        - extra_payment_mode

Now you have 3 dictionaries, payment_mode and extra_payment_mode contain their own values but combined_payment_mode contains all the values of the previous ones., _(*17)

Extended dictionary

You can create an extended dictionary:, _(*18)

knp_dictionary:
  dictionaries:
    europe:
      type: 'key_value'
      content:
        fr: France
        de: Germany

    world:
      type: 'key_value'
      extends: europe
      content:
        us: USA
        ca: Canada

The dictionary world will now contain its own values in addition to the europe values., _(*19)

Note: You must define the initial dictionary BEFORE the extended one., _(*20)

Transformers

For now, this bundle is only able to resolve your class constants:, _(*21)

my_dictionary:
  - MyClass::MY_CONSTANT
  - Foo
  - Bar

You want to add other kinds of transformations for your dictionary values ? Feel free to create your own transformer !, _(*22)

Add your own transformers

Create your class that implements TransformerInterface. Load your transformer and tag it as knp_dictionary.value_transformer., _(*23)

services:
  App\My\Transformer:
    tags:
      - knp_dictionary.value_transformer

Use your dictionary in twig

You can also use your dictionary in your Twig templates via calling dictionary function (or filter)., _(*24)

{% for example in dictionary('examples') %}
    {{ example }}
{% endfor %}

But you can also access directly to a value by using the same function (or filter), _(*25)

{{ 'my_key'|dictionary('dictionary_name') }}

Faker provider

The KnpDictionaryBundle comes with a faker provider that can be used to provide a random entry from a dictionary., _(*26)

Alice

To register the provider in nelmio/alice, you can follow the official documentation, _(*27)

App\Entity\User:
  john_doe:
    firstname: John
    latnale: Doe
    city: <dictionary('cities')>

Create your own dictionary implementation

Dictionary

Your dictionary implementation must implements the interface Dictionary., _(*28)

It is automaticaly registered with the autoconfigure: true DIC feature., _(*29)

Else you can register it by your self:, _(*30)

services:
  App\Dictionary\MyCustomDictionary:
    tags:
      - knp_dictionary.dictionary

Dictionary Factory

You must create a dictionary factory that will be responsible to instanciate your dictionary., _(*31)

It is automaticaly registered with the autoconfigure: true DIC feature., _(*32)

Else you can register it by your self:, _(*33)

services:
  App\Dictionary\Factory\MyCustomFactory:
    tags:
      - knp_dictionary.factory

Tests

phpspec

composer install
vendor/bin/phpspec run

php-cs-fixer

composer install
vendor/bin/php-cs-fixer fix

phpstan

First install phive., _(*34)

Then..., _(*35)

phive install
tools/phpstan process

rector (optional)

rector process --set php70 --set php71 --set php72 --set code-quality --set coding-style --set symfony34 --set twig240 --set psr-4 --set solid src/ spec/

The Versions

30/04 2018

dev-master

9999999-dev

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

30/04 2018

v2.0.2

2.0.2.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

30/04 2018

dev-fix/service-accessibility

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

30/04 2018

dev-refactoring/new-structure

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

15/02 2018

dev-add-license-1

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

15/02 2018

dev-add-code-of-conduct-1

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

15/02 2018

v2.0.1

2.0.1.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

15/02 2018

dev-fix/documentation

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

31/01 2018

v2.0

2.0.0.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

31/01 2018

2.0.x-dev

2.0.9999999.9999999-dev

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

dev-refactoring/cleanup-before-release

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

09/01 2018

dev-refactoring/restore-travis-config

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

dev-feature/key_value_dictionary

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

dev-feature/refactoring-dictionary-factory

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

dev-feature/refactoring-dictionaries

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

dev-symfony-3

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

20/06 2016

dev-feature/valuetransformer-refactoring

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

18/05 2016

v1.5.2

1.5.2.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

12/02 2016

v1.5.1

1.5.1.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

22/10 2015

v1.5.0

1.5.0.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

05/10 2015

v1.4.1

1.4.1.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

05/10 2015

v1.4.0

1.4.0.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

The Development Requires

by Knplabs

by Shivoham

dictionary

12/08 2015

v1.3.1

1.3.1.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

php >=5.3
symfony/symfony ~2.4

The Development Requires

by Knplabs

by Shivoham

dictionary

05/06 2015

v1.3.0

1.3.0.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

php >=5.3
symfony/symfony ~2.4

The Development Requires

by Knplabs

by Shivoham

dictionary

14/04 2015

v1.2.0

1.2.0.0

Are you often tired to repeat static choices like gender or civility in your apps ?

Sources Download

MIT

The Requires

php >=5.3
symfony/symfony ~2.4

The Development Requires

by Knplabs

by Shivoham

dictionary

18/03 2015

v1.1.1

1.1.1.0

Sources Download

MIT

The Requires

symfony/symfony ~2.4

The Development Requires

phpspec/phpspec ~2.0

by Knplabs

by Shivoham

dictionary

23/02 2015

v1.1.0

1.1.0.0

Sources Download

MIT

The Requires

symfony/symfony ~2.4

The Development Requires

phpspec/phpspec ~2.0

by Knplabs

by Shivoham

dictionary

21/11 2014

v1.0.0

1.0.0.0

Sources Download

MIT

The Requires

symfony/symfony ~2.4

The Development Requires

phpspec/phpspec ~2.0

by Knplabs

by Shivoham

dictionary

symfony-bundle dictionary-bundle

Are you often tired to repeat static choices like gender or civility in your apps ?

knplabs/dictionary-bundle

The README.md

DictionaryBundle

Requirements

Installation

Maintainers

Basic usage

Dictionary form type

Validation constraint

Advanced usage

Available types

Callable dictionary

Iterator based dictionary

Combined dictionary

Extended dictionary

Transformers

Add your own transformers

Use your dictionary in twig

Faker provider

Alice

Create your own dictionary implementation

Dictionary

Dictionary Factory

Tests

phpspec

php-cs-fixer

phpstan

rector (optional)

The Versions

dev-master

The Requires

The Development Requires

by Knplabs

by Shivoham

v2.0.2

The Requires

The Development Requires

by Knplabs

by Shivoham

dev-fix/service-accessibility

The Requires

The Development Requires

by Knplabs

by Shivoham

dev-refactoring/new-structure

The Requires

The Development Requires

by Knplabs

by Shivoham

dev-add-license-1

The Requires

The Development Requires

by Knplabs

by Shivoham

dev-add-code-of-conduct-1

The Requires

The Development Requires

by Knplabs

by Shivoham

v2.0.1

The Requires

The Development Requires

by Knplabs

by Shivoham

dev-fix/documentation

The Requires

The Development Requires

by Knplabs

by Shivoham

v2.0

The Requires

The Development Requires

by Knplabs

by Shivoham

2.0.x-dev

The Requires

The Development Requires

by Knplabs