WordPress开发中使用esc_html()等函数转义输出以提高安全性

作为一名WordPress开发者,除了需要具备功能开发的能力,还要具备对产品安全性的保障能力,这些都需要在不断的开发实践中不 ...

作为一名WordPress开发者,除了需要具备功能开发的能力,还要具备对产品安全性的保障能力,这些都需要在不断的开发实践中不断提高。今天我们就来一起学习WordPress开发中使用esc_html()等函数转义输出以提高安全性。

规则1:不要信任任何人和事

当我们谈论转义时,通常是关于我们从数据库中获得的信息。但是请记住,该数据库不是受信任的数据源。让我给你看一个例子:

echo ‘<label for=”‘ . $id . ‘”>’ . $label . ‘</label>’; …

我们在HTML属性中有一个$label变量,在HTML标签中有另一个变量。假设它的值来自数据库,并且包含以下内容:

‘<script>window.location = “https://not-rudrastyh.com”;</script>’

无需以表格形式显示标签(label),您的网站用户将被重定向到一些阴暗的网站。看起来有些恐怖吧!

同样的事情也适用于HTML属性中的$id变量。比如:

‘”><script>window.location = “https://not-rudrastyh.com”;</script>’

重定向造成的结果对你来说可能不算严重,但是如果有某种比特币挖掘脚本怎么办?

规避方法

为了防止在上面的示例中发生此类问题,我们要做的就是将输出内容中使用esc_attr()和esc_html() 相应地包装一下。方法如下:

echo ‘<label for=”‘ . esc_attr( $id ) . ‘”>’ . esc_html( $label ) . ‘</label>’; …

太好了,现在您已经了解了基础知识,让我们继续进行。

什么时候需要转义?

这是一个很好的问题,因为在WordPress的官方文档中,有人说 WordPress的某些功能负责准备输出数据,并举例the_title()说明了这些功能。

让我们现在检查一下!我目前没有说过要更改phpMyAdmin中的标题,这当然也是可能的,所以让我们创建一个标题如下的文章:

WordPress开发中使用esc_html()等函数转义输出以提高安全性 (https://www.wpzhuti.com/) WordPress开发教程 第1张

在使用the_title()或get_the_title()打印标题的网站页面上,我们得到了以下信息:

WordPress开发中使用esc_html()等函数转义输出以提高安全性 (https://www.wpzhuti.com/) WordPress开发教程 第2张

但请注意,尽管它使用相同的get_the_title()功能来打印标题,但网站后台/wp-admin中的文章列表WP_Posts_List_Table并未损坏。

WordPress开发中使用esc_html()等函数转义输出以提高安全性 (https://www.wpzhuti.com/) WordPress开发教程 第3张

在WordPress管理页面中,函数get_the_title()通过esc_html()这种方式进行了转义:

add_filter( ‘the_title’, ‘esc_html’ );

WordPress在真正重要的地方转义了一切,同时当我们谈论网站前端时,它为用户提供了自由。

这就是我的想法 – 您可以选择在创建自定义主题的模板时决定是否转义标题等,但是如果您正在开发插件或WordPress管理员的某种UI界面,则转义是永远是必须的。

从函数名称可以理解,它为HTML属性中的用法准备了数据。

esc_attr()

删除不正确的utf8字符,

将< (小于)、> (大于)、& (与)、” (双引号)和’(单引号)字符转换为HTML实体,

永远不会对实体进行双重编码。

例如:

echo ‘<a href=”” title=”View post: ‘ . esc_attr( get_the_title() ) . ‘”>…’;

还可以使用过滤钩子attribute_escape添加其他转义。

请记住:

请勿使用esc_attr()来转义src、href属性的数据– 而是使用esc_url(),

也不要将其用于value属性,因为它可能导致HTML实体丢失和数据库中存储的值不正确,请改用esc_textarea()。这是因为esc_attr()不会对实体进行双重编码。

esc_html()

准备在HTML中使用的文本。与esc_attr()函数的唯一区别在于,它有一个连接到函数输出的过滤器钩子- esc_html而不是attribute_escape。

示例 – 假设您有一个类似的字符串<div class=”block”>,并且想要在网站内容中显示它。

$string = ‘<div class=”block”>’;

echo esc_html( $string ); // 输出 <div class=”block”>

esc_url()

检查/尝试修复和清理网址。以下是转义顺序:

用%20替换空格,

删除网址中不允许使用的符号,例如反斜杠,

如果URL协议是mailto:,从使用私有函数_deep_replace()排除符号%0d、%0a、%0D、%0A等字符串,这意味着字符串%0%0%0AAA将被转换为空字符串,而不是str_replace()将返回的%0%0AA ,

将替换;//为://,防止万一发生错误的情况,

如果该网址不包含方案,除非该URL 是一个以/,#或?或php文件开头的相对链接,否则将添加前缀http://。

如果第三个函数参数$_context等于display(默认情况下),则&符号将替换为&,并将单引号替换为英文的’,

用%5B和%5D编码方括号。

检查是否允许使用URL协议,如果不允许-返回空字符串,

在最后,将clean_url滤镜挂钩应用于结果。

echo ‘<a href=”‘ . esc_url( $url ) . ‘”>…</a>’;

允许的协议

默认情况下,WordPress列出了可以使用函数wp_allowed_protocols()检索的良好协议,如下:

http / https

ftp / ftps

mailto

news

irc

gopher

nntp

feed

telnet

mms

sms

rtsp

svn

tel

fax

xmpp

webcal

urn

如上所述,如果您的网址既不是相对网址,也不包含任何这些协议,则将返回空字符串。但是,如果您想转义这样的Skype链接skype:rudrastyh?call怎么办?

您可以使用此过滤器挂钩kses_allowed_protocols将“ skype”添加到允许的协议列表中。例:

add_filter( ‘kses_allowed_protocols’, function( $protocols ) {

$protocols[] = ‘skype’;

return $protocols;

});

另一种方法是在转义时直接指定协议:

$url = ‘skype:rudrastyh?call’;

echo ‘<a href=”‘ . esc_url( $url, array( ‘skype’ ) ) . ‘”>Call Misha</a>’;

esc_js()

转义字符串以用作内联JavaScript,例如onclick=””,onsubmit=””或在<script>标记内。请注意,在这种情况下,JavaScript中的文本字符串必须始终用单引号引起来!

删除不正确的utf8字符,

转义单引号’,

将< (小于)、> (大于)、& (与)、” (双引号)字符转换为HTML实体< > & ” ,

在行末添加\n。

您现在看到了esc_js()和esc_attr()之间的区别吗?

让我们看一个例子:

<?php

$text = “some single ‘ quote

then the next line and <b>html code</b>”;

?>

<script>

alert(‘<?php echo esc_js($text) ?>’);

</script>

如果您不打算在此示例中使用esc_js(),将出现JavaScript错误并且没有发生任何事情,但是在我们的情况下,我们在浏览器中收到如下警告消息:

WordPress开发中使用esc_html()等函数转义输出以提高安全性 (https://www.wpzhuti.com/) WordPress开发教程 第4张

esc_textarea()

为<textarea>标签内的用法准备一个字符串。

将< (小于)、> (大于)、& (与)、” (双引号)和’(单引号)字符转换为HTML实体

支持本地化翻译

还值得一提的是,对应的支持本地化翻译的函数:esc_html__(),esc_html_e(),esc_html_x(),esc_attr__(),esc_attr_e(),esc_attr_x()这不仅是翻译字符串,同时也转义它们。

esc_html_e( ‘Hello World’, ‘some_text_domain’ );

// 和下面的效果一样

echo esc_html( __( ‘Hello World’, ‘some_text_domain’ ) );

WordPress教程建站教程

实现WordPress博客蜘蛛爬行记录统计教程

2020-9-8 14:26:15

WordPress教程建站教程

如何让投稿者也可以在WordPress网站上传图片?

2020-9-8 14:26:29

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索