Skip to content

escape

escape 用于将变量编码或转义为 html、url、单引号、十六进制、十六进制实体、javascript 和 mail 格式。默认情况下，使用 html 格式进行转义。

基本用法

{$myVar|escape}

参数

参数位置 类型 必需 可选值 默认值 描述
1 字符串 否 html、htmlall、url、urlpathinfo、quotes、hex、hexentity、javascript、mail html 要使用的转义格式。
2 字符串 否 ISO-8859-1、UTF-8，以及 htmlentities() 支持的任何字符集 UTF-8 传递给 htmlentities() 等函数的字符集编码。
3 布尔值 否 FALSE TRUE 从 & 转义为 &（仅适用于 html 和 htmlall）

示例

<?php

$smarty->assign('articleTitle',
                "'Stiff Opposition Expected to Casketless Funeral Plan'"
                );
$smarty->assign('EmailAddress','smarty@example.com');

以下是示例 escape 模板行及其输出：

{$articleTitle}
'Stiff Opposition Expected to Casketless Funeral Plan'

{$articleTitle|escape}
&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;

{$articleTitle|escape:'html'}    {* 转义 & " ' < > *}
&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;

{$articleTitle|escape:'htmlall'} {* 转义所有 HTML 实体 *}
&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;

<a href="?title={$articleTitle|escape:'url'}">click here</a>
<a
href="?title=%27Stiff%20Opposition%20Expected%20to%20Casketless%20Funeral%20Plan%27">click here</a>

{$articleTitle|escape:'quotes'}
\'Stiff Opposition Expected to Casketless Funeral Plan\'

<a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a>
{$EmailAddress|escape:'mail'}    {* 将电子邮件转换为文本 *}
<a href="mailto:%62%6f%..snip..%65%74">&#x62;&#x6f;&#x62..snip..&#x65;&#x74;</a>

{'mail@example.com'|escape:'mail'}
smarty [AT] example [DOT] com

{* "rewind" 参数注册当前位置 *}
<a href="$my_path?page=foo&rewind={$my_uri|escape:url}">click here</a>

此代码片段对于电子邮件非常有用，但请参阅 {mailto}。

{* 对电子邮件地址进行混淆 *}
<a href="mailto:{$EmailAddress|escape:'hex'}">{$EmailAddress|escape:'mail'}</a>

另请参阅 escaping smarty parsing、{mailto} 和 obfuscating email addresses 页面。