Php/docs/function.rawurlencode

• PHP Manual
• URL 函数
• 按照 RFC 3986 对 URL 进行编码

rawurlencode

(PHP 4, PHP 5, PHP 7)

rawurlencode — 按照 RFC 3986 对 URL 进行编码

说明

rawurlencode ( string $str ) : string

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

参数

str

要编码的 URL。

返回值

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

Note:

在 PHP 5.3.0 之前，rawurlencode 根据 » RFC 1738 来编码波浪线（~）。

更新日志

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

范例

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

<?phpecho '<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 构成部分去传递信息：

Example #2 rawurlencode() 示例 2

<?phpecho '<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">

参见

• rawurldecode() - 对已编码的 URL 字符串进行解码
• urldecode() - 解码已编码的 URL 字符串
• urlencode() - 编码 URL 字符串
• » RFC 3986