README

String transformers collection.

Library uses transformer concept. You may write new transformer implementing \Zelenin\Ddd\String\Domain\Service\Transformer interface. Built-in transformers:

• RawTransformer uses a string as is
• IntlNormalizeTransformer normalizes a string (uses php-intl)
• IntlTransliterator transliterates a string (uses php-intl)
• UrlifyTransformer cleans a string for friendly url (slugifier)
• TemplateTransformer transforms a string according a template

Installation

Composer

The preferred way to install this extension is through Composer.

Either run

php composer.phar require zelenin/string "~0.0.0" 

or add

"zelenin/string": "~0.0.0" 

to the require section of your composer.json

Usage

$string = 'Jeanne Françoise Julie Adélaïde Récamier'; $transformers = [ new IntlNormalizeTransformer(), new IntlTransliterateTransformer(), new UrlifyTransformer(), new TemplateTransformer('{id}-{slug}', ['{id}' => $model->id]) ]; $transformer = new Transformer(new TransformerCollection($transformers)); $slug = $transformer->transform($string); // '12-jeanne-francoise-julie-adelaide-recamier'

You may set some options:

$string = 'Jeanne Françoise Julie Adélaïde Récamier'; $transformers = [ new IntlNormalizeTransformer(Normalizer::FORM_C), new IntlTransliterateTransformer('Russian-Latin/BGN; Any-Latin; Latin-ASCII; NFD; [:Nonspacing Mark:] Remove; NFKC;'), new UrlifyTransformer('_', false), new TemplateTransformer('{id}-{slug}', ['{id}' => $model->id]) ]; $transformer = new Transformer(new TransformerCollection($transformers)); $slug = $transformer->transform($string);

Author

Aleksandr Zelenin, e-mail: aleksandr@zelenin.me