`singular`

3.11

singular 过滤器在 Twig 3.11 中添加。

singular 过滤器将给定的名词从复数形式转换为单数形式

        1
2
3
4
5
6
        {# English (en) rules are used by default #}
{{ 'partitions'|singular() }}
partition

{{ 'partitions'|singular('fr') }}
partition
    

注意

singular 过滤器是 StringExtension 的一部分，默认情况下未安装。请先安装它

        1
        $ composer require twig/string-extra
    

然后，在 Symfony 项目上，安装 twig/extra-bundle

        1
        $ composer require twig/extra-bundle
    

否则，在 Twig 环境中显式添加扩展

        1
2
3
4
        use Twig\Extra\String\StringExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new StringExtension());
    

参数

locale: 原始字符串的区域设置（仅限于 Symfony inflector 支持的语言，String 组件的一部分）
all: 是否将所有可能的复数形式作为数组返回，默认为 false

注意

在内部，Twig 使用来自 Symfony String 组件的 singularize 方法。