ThinkPHPrawurlencode字符转换代码示例-php教程-PHP中文网

rawurlencode适用于url路径参数、含特殊字符的restful路径、content-disposition文件名等需严格编码的场景，因其对/、@、空格等均编码为%xx，而urlencode保留/、@且空格转+，易致路由错误或解析失败。

thinkphprawurlencode字符转换代码示例

ThinkPHP 中 `rawurlencode` 的正确使用场景

ThinkPHP 本身不封装 rawurlencode，它就是 PHP 原生函数，直接调用即可。但很多人在 URL 拼接、API 参数编码、重定向跳转时误用 urlencode 或漏掉对斜杠 / 的处理，导致后端路由解析失败或参数截断。

关键区别：rawurlencode 会把空格转成 %20，而 urlencode 转成 +；更重要的是，rawurlencode 对 /、:、@ 等字符也做编码，urlencode 则保留它们——这在构造带路径或用户信息的 URL 时非常关键。

URL 路径参数中必须用 `rawurlencode`

比如你要拼一个含用户名（可能含中文、空格、@）的 RESTful 路径：/api/user/张三@domain.com，直接拼会导致路由匹配失败或 404。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

错误写法：urlencode('张三@domain.com') → %E5%BC%A0%E4%B8%89@domain.com（@ 未编码，被当分隔符）
正确写法：rawurlencode('张三@domain.com') → %E5%BC%A0%E4%B8%89%40domain.com（@ 变成 %40）

ThinkPHP 控制器里可这样用：

$username = '张三@domain.com';<br>$encoded = rawurlencode($username);<br>return redirect('/api/user/' . $encoded);

与 `url()` 辅助函数配合时的注意事项

ThinkPHP 的 url() 函数默认会对参数值自动调用 urlencode，不是 rawurlencode。如果你传入的是完整路径片段（如带斜杠的子路径），它不会帮你编码 /，结果就是路由错乱。

不要这样传：url('api/read', ['path' => 'user/张三']) → 生成 /api/read?path=user/%E5%BC%A0%E4%B8%89，看似 OK，但若你本意是路由路径而非查询参数，就错了
要路径嵌套，应手动编码再拼：url('api/read') . '/' . rawurlencode('user/张三')
如果参数值本身已由前端传入且含编码，注意避免重复编码——先 urldecode 再 rawurlencode，否则出现 %25E5%25BC%25A0 这类双层编码

中文文件名下载头中的 `rawurlencode` 实际用法

HTTP 响应头 Content-Disposition 中的 filename= 和 filename*= 对编码要求严格。ThinkPHP 没有内置封装，需手动处理。

兼容性写法（推荐）：

$filename = '报告_2024年.pdf';<br>$encoded = rawurlencode($filename);<br>header('Content-Disposition: attachment; filename="' . $encoded . '"; filename*=UTF-8\'\'' . $encoded);