rawurlencode

(PHP 4, PHP 5, PHP 7, PHP 8)

rawurlencode按照 RFC 3986 对 URL 进行编码

说明

rawurlencode(string $str): string

根据 » RFC 3986 编码指定的字符。

参数

str

要编码的 URL。

返回值

返回字符串,此字符串中除了 -_. 之外的所有非字母数字字符都将被替换成百分号(%)后跟两位十六进制数。这是在 » RFC 3986 中描述的编码,是为了保护原义字符以免其被解释为特殊的 URL 定界符,同时保护 URL 格式以免其被传输媒体(像一些邮件系统)使用字符转换时弄乱。

注意:

在 PHP 5.3.0 之前,rawurlencode 根据 » RFC 1738 来编码波浪线(~)。

更新日志

版本 说明
5.3.4 因为 rawurlencode() 使用了 EBCDIC,所以波浪线字符不会再被编码。
5.3.0 现在符合了» RFC 3986

范例

示例 #1 在 FTP URL 里包含一个密码

<?php
echo '<a href="ftp://user:'rawurlencode('foo @+%/'),
     
'@ftp.example.com/x.txt">';
?>

以上例程会输出:

<a href="ftp://user:foo%20%40%2B%25%2F@ftp.example.com/x.txt">

或者,如果你想通过 URL 的 PATH_INFO 构成部分去传递信息:

示例 #2 rawurlencode() 示例 2

<?php
echo '<a href="http://example.com/department_list_script/',
    
rawurlencode('sales and marketing/Miami'), '">';
?>

以上例程会输出:

<a href="http://example.com/department_list_script/sales%20and%20marketing%2FMiami">

参见

7i24.Com