zelenin/string

String transformers collection

0.0.1 2015-12-23 00:06 UTC

This package is not auto-updated.

Last update: 2024-10-26 18:44:12 UTC


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