Doctrine Inflector 文本变形工具详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00246/article/details/148393957

Doctrine Inflector 文本变形工具详解

inflector Doctrine Inflector is a small library that can perform string manipulations with regard to uppercase/lowercase and singular/plural forms of words. 项目地址: https://gitcode.com/gh_mirrors/in/inflector

什么是Doctrine Inflector？

Doctrine Inflector 是一个强大的PHP文本变形库，专门用于处理英文及其他语言的单词变形转换。它提供了一系列实用的方法，包括：

单复数转换（singularize/pluralize）
大小写转换（camelCase/under_score）
单词首字母大写
URL友好字符串生成
去除重音符号等

这个库在ORM映射、URL生成、表单处理等场景中特别有用，是许多PHP框架和库的基础依赖。

安装指南

安装Doctrine Inflector非常简单，推荐使用Composer进行安装：

composer require doctrine/inflector

安装完成后，你就可以在项目中开始使用这个强大的文本处理工具了。

基础使用教程

创建Inflector实例

首先需要创建Inflector实例，最简单的方式是使用工厂类：

use Doctrine\Inflector\InflectorFactory;

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

默认会创建一个英语的变形器。如果需要其他语言支持，可以指定语言参数：

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

目前支持的语言包括：

英语(ENGLISH)
法语(FRENCH)
挪威语(NORWEGIAN_BOKMAL)
葡萄牙语(PORTUGUESE)
西班牙语(SPANISH)
土耳其语(TURKISH)

手动构建Inflector

如果需要更精细的控制，也可以手动构建Inflector：

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()
    ))
);

核心功能详解

1. 单复数转换

// 复数化
echo $inflector->pluralize('browser');  // 输出 "browsers"

// 单数化
echo $inflector->singularize('browsers'); // 输出 "browser"

2. 命名风格转换

// 类名转表名 (ModelName → model_name)
echo $inflector->tableize('ModelName'); 

// 表名转类名 (model_name → ModelName)
echo $inflector->classify('model_name');

// 转为驼峰命名 (model_name → modelName)
echo $inflector->camelize('model_name');

3. 单词大写处理

$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!

4. URL友好字符串生成

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

5. 去除重音符号

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

高级自定义配置

Doctrine Inflector允许你完全自定义单复数变形规则：

use Doctrine\Inflector\InflectorFactory;
use Doctrine\Inflector\Rules\Pattern;
// 其他必要的use语句...

$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(
        // 类似的复数规则配置
    )
    ->build();

无操作变形器

在某些场景下，你可能需要一个不做任何变形的变形器，可以使用NoopWordInflector：

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

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