Skip to content

Latest commit

 

History

History
226 lines (152 loc) · 6.37 KB

index.rst

File metadata and controls

226 lines (152 loc) · 6.37 KB
Raw

Introduction

The Doctrine Inflector has methods for inflecting text. The features include pluralization, singularization, converting between camelCase and under_score and capitalizing words.

Installation

You can install the Inflector with composer:

$ composer require doctrine/inflector

Usage

Using the inflector is easy, you can create a new Doctrine\Inflector\Inflector instance by using the Doctrine\Inflector\InflectorFactory class:

use Doctrine\Inflector\InflectorFactory;

$inflector = InflectorFactory::create()->build();

By default it will create an English inflector. If you want to use another language, just pass the language you want to create an inflector for to the createForLanguage() method:

use Doctrine\Inflector\InflectorFactory;
use Doctrine\Inflector\Language;

$inflector = InflectorFactory::createForLanguage(Language::SPANISH)->build();

The supported languages are as follows:

  • Language::ENGLISH
  • Language::FRENCH
  • Language::NORWEGIAN_BOKMAL
  • Language::PORTUGUESE
  • Language::SPANISH
  • Language::TURKISH

If you want to manually construct the inflector instead of using a factory, you can do so like this:

use Doctrine\Inflector\CachedWordInflector;
use Doctrine\Inflector\RulesetInflector;
use Doctrine\Inflector\Rules\English;

$inflector = new Inflector(
    new CachedWordInflector(new RulesetInflector(
        English\Rules::getSingularRuleset()
    )),
    new CachedWordInflector(new RulesetInflector(
        English\Rules::getPluralRuleset()
    ))
);

Adding Languages

If you are interested in adding support for your language, take a look at the other languages defined in the Doctrine\Inflector\Rules namespace and the tests located in Doctrine\Tests\Inflector\Rules. You can copy one of the languages and update the rules for your language.

Once you have done this, send a pull request to the doctrine/inflector repository with the additions.

Custom Setup

If you want to setup custom singular and plural rules, you can configure these in the factory:

use Doctrine\Inflector\InflectorFactory;
use Doctrine\Inflector\Rules\Pattern;
use Doctrine\Inflector\Rules\Patterns;
use Doctrine\Inflector\Rules\Ruleset;
use Doctrine\Inflector\Rules\Substitution;
use Doctrine\Inflector\Rules\Substitutions;
use Doctrine\Inflector\Rules\Transformation;
use Doctrine\Inflector\Rules\Transformations;
use Doctrine\Inflector\Rules\Word;

$inflector = InflectorFactory::create()
    ->withSingularRules(
        new Ruleset(
            new Transformations(
                new Transformation(new Pattern('/^(bil)er$/i'), '\1'),
                new Transformation(new Pattern('/^(inflec|contribu)tors$/i'), '\1ta')
            ),
            new Patterns(new Pattern('singulars')),
            new Substitutions(new Substitution(new Word('spins'), new Word('spinor')))
        )
    )
    ->withPluralRules(
        new Ruleset(
            new Transformations(
                new Transformation(new Pattern('^(bil)er$'), '\1'),
                new Transformation(new Pattern('^(inflec|contribu)tors$'), '\1ta')
            ),
            new Patterns(new Pattern('noflect'), new Pattern('abtuse')),
            new Substitutions(
                new Substitution(new Word('amaze'), new Word('amazable')),
                new Substitution(new Word('phone'), new Word('phonezes'))
            )
        )
    )
    ->build();

No operation inflector

The Doctrine\Inflector\NoopWordInflector may be used to configure an inflector that doesn't perform any operation for pluralization and/or singularization. If will simply return the input as output.

This is an implementation of the Null Object design pattern.

use Doctrine\Inflector\Inflector;
use Doctrine\Inflector\NoopWordInflector;

$inflector = new Inflector(new NoopWordInflector(), new NoopWordInflector());

Tableize

Converts ModelName to model_name:

echo $inflector->tableize('ModelName'); // model_name

Classify

Converts model_name to ModelName:

echo $inflector->classify('model_name'); // ModelName

Camelize

This method uses Classify and then converts the first character to lowercase:

echo $inflector->camelize('model_name'); // modelName

Capitalize

Takes a string and capitalizes all of the words, like PHP's built-in ucwords function. This extends that behavior, however, by allowing the word delimiters to be configured, rather than only separating on whitespace.

Here is an example:

$string = 'top-o-the-morning to all_of_you!';

echo $inflector->capitalize($string); // Top-O-The-Morning To All_of_you!

echo $inflector->capitalize($string, '-_ '); // Top-O-The-Morning To All_Of_You!

Pluralize

Returns a word in plural form.

echo $inflector->pluralize('browser'); // browsers

Singularize

Returns a word in singular form.

echo $inflector->singularize('browsers'); // browser

Urlize

Generate a URL friendly string from a string of text:

echo $inflector->urlize('My first blog post'); // my-first-blog-post

Unaccent

You can unaccent a string of text using the unaccent() method:

echo $inflector->unaccent('año'); // ano

Legacy API

The API present in Inflector 1.x is still available, but will be deprecated in a future release and dropped for 3.0. Support for languages other than English is available in the 2.0 API only.

Acknowledgements

The language rules in this library have been adapted from several different sources, including but not limited to: