PHP中的urlencode,htmlentities并不简单

最近看到一篇好文章,所以就对PHP的二个函数(urlencode 和 htmlentities)做个总结,很多事情看上去很简单,但是深入下去并不那么“简单”。

urlencode

很多文章说到 urlencode 函数的时候,都会提到 rawurlencode 函数,二者之间非常的相似,rawurlencode 函数遵循 RFC 3986 协议,urlencode 遵循 RFC 1866 协议。二者应用场景并不一样(不太清楚rawurlencode在何种场景下使用);urlencode 是将空格替换成“+”,rawurlencode 是将空格替换为“%20”。

二者在使用的时候,需要注意是按照何种编码进行转换的,一般是根据PHP文件编码进行转换,比如对于一个中文字符(中)。假如文件编码是 UTF-8 ,编码后得到的结果是%E4%B8%AD;假如文件编码是 GBK ,编码后得到的结果是%D6%D0

大家有没有思考一个问题,urlencode 函数存在的意义? 在 URL 中输入的元素必须是 US-ASCII 的子集,假如包含其它字符,那就是不安全的,所以假如需要使用则必须转码,这样才是一个合格的 URL 。

那么什么样的字符是不安全的呢?下面描述下:

  • ASCII 控制字符,这些字符是不能打印的,既然不能打印,那么用户也不能输入,所以需要转码。
  • Non-ASCII,比如中文字符。
  • 保留字符,这很重要。 URL 之所以能够被浏览器解析就在于某些字符(比如 :,/符号)具有特殊含义(具有特殊含义才需要保留啊)。那么假如用户要“取消”这些保留字符的含义,那么就必须转码。
  • 不安全字符,这些字符应该可以称为“应用字符”,对应的就是 HTML 中的“实体字符”,典型的不安全字符包括“<”,“\”,“%”等。

平时我们拷贝一个含有中文的 URL 到浏览器的时候,浏览器会自动转码。做了个实验,对于 Chrome浏览器来说,页面编码不管是 UTF-8 还是 GBK , urlencode 都是使用 UTF-8 编码进行编码的,这间接也说明应该统一使用 UTF-8。

几个注意点:

(1)在 PHP 中,仅仅对于需要“编码”的字符进行编码,不然会有错误,比如:

$str = "中国";
$url = "http://blog.newyingyong.cn/" . urlencode($str);
//不要对整个URL进行编码,否则将URL中的保留字符也转码了,这样这就不是一个正确的URL

(2)在 WEB 开发中,建议对数据都进行 urlencode,这个编码与 WWW 表单 POST 数据的编码方式是一样的,同时与 application/x-www-form-urlencoded 的媒体类型编码方式一样。

(3)$_GET$_REQUEST 会自动 urldecode,所以需要注意,尤其对于+字符来说,假如二次 urldecode,则会丢失该字符,因为系统进行二次解码,会将“+”符号变为空格符号。201704备注$_POST 变量也会主动 urldecode。同时假如服务器端程序自己构建数据发送请求,需要确保进行 urlencode,举个例子仔细体会下:

$url = 'http://localhost/t.php?parama=' . urlencode('a+b c');
$url = 'http://localhost/t.php?a=a+b c'; //比较没有 urlencode 处理的区别
$data = array(
    'paramb' => "a+b c",
);

$headers = array(
   'Content-Type: application/x-www-form-urlencoded',
);

$options = array(
    'http' => array(
        'method' => 'POST',
        //http_build_query 是 urlencode 的封装版,本质没有太大区别
        'content' => http_build_query($data),
        'header' => implode("\r\n", $headers),
    )
);

$rs = stream_context_create($options) ;
echo file_get_contents($url, false, $rs);

htmlentities

这个函数的基本定义如下:在 HTML 中,某些字符具有特殊含义(称为应用字符),那么为了表达这些字符的本来含义,就必须使用该函数进行处理。

比如在 HTML 中 “<”和“>”符号可以组合起来表达很多 HTML 元素(浏览器执行的时候就会看到效果),假如仅仅需要表示为“<”和“>”符号,那么就要使用该函数将二者转换为<>,这些字符也叫“实体字符”。

和 htmlentities 函数比较类同的一个函数是 htmlspecialchars , 个人觉得手册中描述的很好:

Certain characters have special significance in HTML, and should be represented by HTML
entities if they are to preserve their meanings. This function returns a string with these conversions made

二者的区别在于:

  • htmlentities 是转换所有的字符为实体字符,而 htmlspecialchars 仅仅转换部分字符(包括 &<>"'
  • htmlentities 仅仅能处理 native characterset ,一般是 ASCII。而 htmlspecialchars 能指定特定字符集进行转换(这个观点已经陈旧)

在开发中,一般发送的数据假如不是富文本模式,则建议使用 htmlspecialchars 函数进行处理避免出现 XSS 攻击。当然为了不破坏原始发送数据,入库的时候不做任何改变,在出库渲染的时候进行转义处理;假如发送的数据是富文本模式,则不应该转义了,这个处理方式可能就是另外的逻辑了。

在本文中为什么同时提到 urlencode 和 htmlentities呢,在 PHP 手册中提到这么下面一段代码,个人理解了好一会还是不得其法。

$query_string = 'foo=' . urlencode($foo) . '&bar=' . urlencode($bar);
echo '<a href="mycgi?' . htmlentities($query_string) . '">';

在 stackoverflow 找到这么一篇解疑,说的很好。

This is not about HTML entities in URLs. This is about you putting arbitrary data into HTML, which means you need to HTML escape any special characters in it. That this data happens to be a URL is irrelevant.

  • You need to escape any arbitrary data you put into the URL with urlencode to preserve characters with a special meaning in the URL.
  • The arbitrary blob of data you get from step one needs to be HTML escaped for the same reasons when put into HTML. As you see in your example, there's an & in your data which is required to be escaped to & by HTML rules.

If you did not use the URL in an HTML context, there'd be no need to HTML escape it. HTML entities have no place in a URL. A URL in an HTML context must be HTML escaped though, like any other data

这二个函数的转码用的场景是不一样的,urlencode 一般是对 URL 转码。而 htmlentities 是对 HTML 的元素进行转码,之所以有联系,是因为 HTML 中的“a”,"image"标签的值可能会是一个 URL。而在 URL 中实体字符也是能够被浏览器自动转换的,所以为避免错误,可以采用上面一段的代码。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,560评论 18 399
  • php usleep() 函数延迟代码执行若干微秒。 unpack() 函数从二进制字符串对数据进行解包。 uni...
    思梦PHP阅读 1,980评论 1 24
  • PHP常用函数大全 usleep() 函数延迟代码执行若干微秒。 unpack() 函数从二进制字符串对数据进行解...
    上街买菜丶迷倒老太阅读 1,347评论 0 20
  • 已经同步到gitbook,想阅读的请转到gitbook: Django 1.10 中文文档 URL dispatc...
    leyu阅读 14,186评论 0 16