2017 © Pedro Peláez
 

library string-generator-bundle

Generate random strings for IDs or keys using property annotations

image

vivait/string-generator-bundle

Generate random strings for IDs or keys using property annotations

  • Wednesday, July 25, 2018
  • by robincawser
  • Repository
  • 8 Watchers
  • 14 Stars
  • 24,125 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 8 Forks
  • 3 Open issues
  • 15 Versions
  • 10 % Grown

The README.md

StringGeneratorBundle

Build Status, (*1)

This bundle allows you to automatically generate a unique random string on an entity property, useful for creating keys. Using Doctrine's prePersist callback, StringGenerator adds the generated string to a property before the entity is persisted. It also checks whether the string is unique to that property (just in case) and if not, quietly generates a new string., (*2)

Install

Run: composer require vivait/string-generator-bundle:^3.0 to install the bundle., (*3)

If you are using PHP 5.3 or 5.4 you can use the legacy versionvivait/string-generator-bundle:^1.1, (*4)

Check latest releases, (*5)

Update your AppKernel:, (*6)

public function registerBundles()
{
    $bundles = array(
        ...
        new Vivait\StringGeneratorBundle\VivaitStringGeneratorBundle(),
}

Bundled generators

StringGenerator

Generates a random string based on a pool or characters. Defaults:, (*7)

@Generate(generator="string", options={"length"=8, "chars"="0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ", "prefix"=""})

SecureStringGenerator

Generates a secure random string using ircmaxell's RandomLib. The library provides three different strengths of strings(currently high is unavailable), low and medium. Defaults:, (*8)

@Generate(generator="secure_string", options={"length"=32, "chars"="0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ", "strength"="medium"})

SecureBytesGenerator

Generates a secure random byte string using the Symfony\Component\Security\Core\Util\SecureRandom class. Defaults:, (*9)

@Generate(generator="secure_bytes", options={"length"=8})

UuidStringGenerator

For use this generator you should require the package ramsey/uuid in your application., (*10)

For generating a UUID:, (*11)

@Generate(generator="uuid_string", options={"version"=4})

You can use also namespaced versions (v3 and v5). For example with the v5:, (*12)

@Generate(generator="uuid_string", options={"version"=5}, namespace="my_namespace")

Usage

Add the @Generate(generator="generator_name") annotation to an entity property (where generator_name is the name of a generator defined in the configuration)., (*13)

generator is a required property of the annotation., (*14)

use Vivait\StringGeneratorBundle\Annotation\GeneratorAnnotation as Generate;

/**
 * Api
 *
 * @ORM\Table()
 * @ORM\Entity()
 */
class Api
{
    /**
     * @var integer
     *
     * @ORM\Column(name="id", type="guid")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="UUID")
     */
    private $id;

    /**
     * @var string
     *
     * @ORM\Column(name="api_id", type="string", nullable=false)
     * @Generate(generator="string")
     */
    private $api_key;

Options

Generators that implement ConfigurableGeneratorInterface, such as the bundled generators have options which can be configured., (*15)

To do this, set the options parameter on the annotation:, (*16)

@Generate(generator="string", options={"length"=32, "chars"="ABCDEFG"})

Callbacks

It's possible to define callbacks on the Generator class that you are using. For example, with the bundled StringGenerator, you may wish to set the a prefix on the generated string, (*17)

This can be achieved by setting the callbacks option. For example:, (*18)

@Generate(generator="my_generator", callbacks={"setPrefix"="VIVA_"})

Here, setChars() is called in the StringGenerator class, passing ABCDEFG as a parameter., (*19)

It's even possible to set a callback value dynamically:, (*20)

/**
 * @var string
 *
 * @ORM\Column(name="short_id", type="string", length=255, nullable=false)
 * @Generate(generator="string", options={"length"=32}, callbacks={"setPrefix"="getPrefix"})
 */
private $short_id;

public function getPrefix()
{
    return $this->getType(); //"default"
}

In this case StringGenerator::setPrefix("default") will be called, (*21)

Unique

Setting unique is boolean and tell if the string must be unique or not, by default true, (*22)

@Generate(generator="secure_bytes", unique=false)

Override

By default, override is set to true, so a string is always generated for a property. However, by setting override to false, only null properties will have a string generated for them., (*23)

@Generate(generator="string", override=false)

Custom generators

You can use your own generators by implementing GeneratorInterface and defining the generator in your services.yml file with the tag vivait_generator.generator and an alias, which will be used to identify the Generator in annotations., (*24)

vivait_generator.generator.secure_bytes:
    class: Vivait\StringGeneratorBundle\Generator\SecureBytesGenerator
    tags:
        - { name: vivait_generator.generator, alias: 'secure_bytes' }

To create configurable generators, implement ConfigurableGeneratorInterface. This interface uses Symfony\Component\OptionsResolver\OptionsResolver to set the generator configuration., (*25)

Set default options:, (*26)

/**
 * @param OptionsResolver $resolver
 */
public function getDefaultOptions(OptionsResolver $resolver)
{
  $resolver->setDefaults(
      [
        'chars'  => $this->chars,
        'length' => $this->length,
        'prefix' => $this->prefix,
      ]
  );
}
  ```

Do something with options:

```php
/**
 * @param array $options
 */
public function setOptions(array $options)
{
    $this->chars  = $options['chars'];
    $this->length = $options['length'];
    $this->prefix = $options['prefix'];
}

Upgrading from version 1 to version 2

Defining generators in configuration was deprecated in version 2 in favour of service definitions, so they must be removed., (*27)

  1. For any CUSTOM generators you have added, you must now define them as services with a vivait_generator.generator tag and an alias attribute. You will not need to do this for the bundled default generators., (*28)

    my_generator:
    class: App\Generator\MyGenerator
    tags:
        - { name: vivait_generator.generator, alias: 'my_generator' }

  2. Remove all vivait_string_generator configuration from your project, (*29)

Upgrading from version 2 to version 3

  1. Remove all vivait_string_generator configuration from your project if not already gone as it will no longer be recognised.

The Versions

25/07 2018

dev-feature/v3

dev-feature/v3

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

11/12 2017

dev-master

9999999-dev

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

11/12 2017

2.1.1

2.1.1.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

30/11 2017

2.1.0

2.1.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

12/04 2017

2.0.0

2.0.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

26/01 2016

1.2.3

1.2.3.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

22/04 2015

1.2.2

1.2.2.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

05/12 2014

1.2.1

1.2.1.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

05/12 2014

1.2.0

1.2.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

04/12 2014

1.1.1

1.1.1.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robin Cawser

03/12 2014

1.1.0

1.1.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

The Requires

 

The Development Requires

by Robin Cawser

02/12 2014

1.0.1

1.0.1.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

The Requires

 

The Development Requires

by Robin Cawser

02/12 2014

dev-develop

dev-develop

Generate random strings for IDs or keys using property annotations

  Sources   Download

The Requires

 

The Development Requires

by Robin Cawser

02/12 2014

1.0

1.0.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

The Requires

 

The Development Requires

by Robin Cawser

01/12 2014

v0.1

0.1.0.0

Generate random strings for IDs or keys using property annotations

  Sources   Download

The Requires

 

The Development Requires

by Robin Cawser