Inflector¶

Resumo dos métodos de Inflexão e Suas Saídas¶

Resumo rápido dos métodos embutidos no Inflector e os resultados que produzem quando fornecidos um argumento de palavra composta.

Criando as formas singulares e plurais¶

static Cake\Utility\Inflector::singularize($singular)¶

static Cake\Utility\Inflector::pluralize($singular)¶

Tanto pluralize() quanto singularize() funcionam para a maioria dos substantivos do Inglês. Caso seja necessário o suporte para outras línguas, você pode usar Configuração da inflexão para personalizar as regras usadas:

// Apples
echo Inflector::pluralize('Apple');

// Person
echo Inflector::singularize('People');

Criando as formas CamelCase e nome_sublinhado¶

static Cake\Utility\Inflector::camelize($underscored)¶

static Cake\Utility\Inflector::underscore($camelCase)¶

Estes métodos são úteis para a criação de nomes de classe ou de propriedades:

// ApplePie
Inflector::camelize('Apple_pie')

// apple_pie
Inflector::underscore('ApplePie');

É importante ressaltar que underscore() irá converter apenas palavras formatadas em CamelCase. Palavras com espaços serão convertidas para caixa baixa, mas não serão separadas por sublinhado.

Criando formas legíveis para humanos¶

static Cake\Utility\Inflector::humanize($underscored)¶

Este método é útil para converter da forma sublinhada para o “Formato Título” para a leitura humana:

// Apple Pie
Inflector::humanize('apple_pie');

Criando formatos para nomes de tabelas e classes¶

static Cake\Utility\Inflector::classify($underscored)¶

static Cake\Utility\Inflector::dasherize($dashed)¶

static Cake\Utility\Inflector::tableize($camelCase)¶

Ao gerar o código ou usar as convenções do CakePHP, você pode precisar inferir os nomes das tabelas ou classes:

// UserProfileSettings
Inflector::classify('user_profile_settings');

// user-profile-setting
Inflector::dasherize('UserProfileSetting');

// user_profile_settings
Inflector::tableize('UserProfileSetting');

Criando nomes de variáveis¶

static Cake\Utility\Inflector::variable($underscored)¶

Nomes de variáveis geralmente são úteis em tarefas de meta-programação que involvem a geração de código ou rotinas baseadas em convenções:

// applePie
Inflector::variable('apple_pie');

Criando strings de URL seguras¶

static Cake\Utility\Inflector::slug($word, $replacement = '-')¶

slug() converte caracteres especiais em suas versões normais e converte os caracteres não encontrados e espaços em traços. O método slug() espera que a codificação seja UTF-8:

// apple-puree
Inflector::slug('apple purée');

Configuração da inflexão¶

As convenções de nomes do CakePHP podem ser bem confortáveis. Você pode nomear sua tabela no banco de dados como big_boxes, seu modelo como BigBoxes, seu controlador como BigBoxesController e tudo funcionará automaticamente. O CakePHP entrelaça todos estes conceitos através da inflexão das palavras em suas formas singulares e plurais.

Porém ocasionalmente (especialmente para os nossos amigos não Anglófonos) podem encontrar situações onde o infletor do CakePHP (a classe que pluraliza, singulariza, transforma em CamelCase e em nome_sublinhado) não funciona como você gostaria. Caso o CakePHP não reconheça seu “quaisquer” ou “lápis”, você pode ensiná-lo a entender seus casos especiais.

Inflector::rules('singular', ['/^(bil)er$/i' => '\1', '/^(inflec|contribu)tors$/i' => '\1ta']);
Inflector::rules('uninflected', ['singulars']);
Inflector::rules('irregular', ['phylum' => 'phyla']); // The key is singular form, value is plural form