Twig

灵活、快速和安全的
PHP 模板引擎

a Symfony Product
您正在阅读 Twig 3.x 的文档。切换到 Twig 1.x, 2.x 的文档。

问题 & 反馈

许可证

Twig 文档 是在新的 BSD 许可证 下许可的。

slug

slug 过滤器将给定的字符串转换为另一个仅包含安全 ASCII 字符的字符串。

这是一个例子

1
2
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug }}
Workspace-settings

单词之间默认的分隔符是破折号 (-),但您可以
通过传递选择器作为参数来定义您选择的选择器

1
2
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug('/') }}
Workspace/settings

slugger 会自动检测原始字符串的语言,但您也可以使用第二个参数显式指定它

1
{{ '...'|slug('-', 'ko') }}

slug 过滤器使用 Symfony 的同名方法
AsciiSlugger.

注意

slug 过滤器是 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());

参数

  • separator: 用于连接单词的分隔符(默认为 -
  • locale: 原始字符串的区域设置代码,如 RFC 5646 中定义