WordPress函数文档esc_html()
发布于
by
将 & ” ’（小于号，大于号，&，双引号，单引号）编码，转成HTML 实体 描述 将 <…
将 & ” ’（小于号，大于号，&，双引号，单引号）编码，转成HTML 实体
描述
将 < > & ” ‘（小于号，大于号，&，双引号，单引号）编码，转成HTML 实体，已经是实体的并不转换。
功能和 esc_attr() 类似。
用法
<?php esc_html( $text ) ?>
参数
$text
(string) (必填) 将编码成实体的文本。
默认值: None
返回值
HTML (string)
已经编码成 HTML 实体的文本。
示例
|
1
2
3
4
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
$html = esc_html( ‘<a href=”http://www.example.com/”>A link</a>’ );
|
$html now contains this:
|
1
2
3
4
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
<a href="http://www.example.com/">A link</a>
|
Which would be displayed in an HTML document as:
|
1
2
3
4
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
<a href=“http://www.example.com/”>A link</a>
|
Instead of this:
A link
注意
- 使用到 the ‘esc_html’ 过滤器.
历史
- 添加于 版本: 2.8.0
源文件
esc_html() 函数的代码位于 wp-includes/formatting.php.
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
/**
* Escaping for HTML blocks.
*
* @since 2.8.0
*
* @param string $text
* @return string
*/
function esc_html( $text ) {
$safe_text = wp_check_invalid_utf8( $text );
$safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
/**
* Filter a string cleaned and escaped for output in HTML.
*
* Text passed to esc_html() is stripped of invalid or special characters
* before output.
*
* @since 2.8.0
*
* @param string $safe_text The text after it has been escaped.
* @param string $text The text prior to being escaped.
*/
return apply_filters( ‘esc_html’, $safe_text, $text );
}
|
相关
See: Data Validation article for an in-depth discussion of input and output sanitization.
- esc_html()
- esc_html__()
- esc_html_e()
- esc_attr()
- esc_attr__()
- esc_attr_e()
- esc_js()
- esc_sql()
- esc_textarea()
- esc_url()
- esc_url_raw()
- 原文：http://codex.wordpress.org/Function_Reference/esc_html
类别：WordPress函数文档、
本文收集自互联网，转载请注明来源。
如有侵权，请联系 wper_net@163.com 删除。
猜你喜欢GUESS YOU LIKE
评论功能已经关闭!