PHP字符串URL编码urlencode()函数：参数传递实测可用-php教程-PHP中文网

urlencode() 是 php 中专用于 url 参数值编码的函数，将空格、中文、标点等转为 %xx 格式，保留字母数字及 -_.~，不可用于整url编码，适用 get 请求拼接等场景。

php字符串url编码urlencode()函数：参数传递实测可用

urlencode() 是 PHP 中用于对字符串进行 URL 编码（即百分号编码）的标准函数，主要作用是将特殊字符（如空格、中文、标点等）转换为 %XX 格式，确保字符串可安全用于 URL 查询参数中。它不是万能的“加密”或“转义”，而是专为 HTTP GET 请求参数设计的编码方式。

urlencode() 的基本行为和适用场景

该函数会将以下字符进行编码：

空格 → %20（注意：不是 +，那是 application/x-www-form-urlencoded 表单提交时浏览器做的额外处理）
中文（如“你好”）→ %E4%BD%A0%E5%A5%BD（UTF-8 编码下的字节序列分别编码）
符号如 / ? & = # 等 → 全部转为对应十六进制形式
字母、数字、- _ . ~ 保持原样（不编码）

✅ 实测可用场景：拼接 GET 请求 URL、构造 cURL 参数、生成跳转链接中的 query 字段。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

常见误区与避坑提醒

直接用 urlencode() 处理整个 URL 是错误的——它只适用于 参数值，不是整个 URL。

❌ 错误：urlencode("https://example.com/?q=测试") → 把冒号、斜杠全编码，结果不可访问
✅ 正确："https://example.com/?q=" . urlencode("测试")
⚠️ 注意：如果参数名本身含特殊字符（极少见），也要单独编码；通常只编码参数值
⚠️ 中文网站若页面编码不是 UTF-8（如 GBK），需先 iconv("GBK", "UTF-8", $str) 再 urlencode

对比其他类似函数

别混淆这几个常用函数：

rawurlencode()：更严格，空格也编码为 %20（urlencode() 在老版本里曾转成 +，但现代 PHP 已统一为 %20；两者目前行为一致，但语义上 rawurlencode() 更推荐用于 REST API 场景）
http_build_query()：批量处理关联数组，内部自动调用 urlencode()，适合构造完整 query string
urldecode() 和 rawurldecode()：对应解码，注意匹配使用（urlencode() 编码的用 urldecode() 解）

实测代码片段（可直接运行验证）

以下代码在 PHP 7.4+ 和 8.x 均通过验证：

<?php $str = "用户名=test&城市=北京+上海";
echo urlencode($str);
// 输出：%E7%94%A8%E6%88%B7%E5%90%8D%3Dtest%26%E5%9F%8E%E5%B8%82%3D%E5%8C%97%E4%BA%AC%2B%E4%B8%8A%E6%B5%B7
<p>// 拼接 URL 示例
$url = "<a href="https://www.php.cn/link/b9bfa33d7db02d23b9ee762672dbf850">https://www.php.cn/link/b9bfa33d7db02d23b9ee762672dbf850</a>?" . http_build_query([
'q' => 'PHP 字符串编码',
'page' => 1
]);
// 输出：<a href="https://www.php.cn/link/b9bfa33d7db02d23b9ee762672dbf850?q=PHP+%E5%AD%97%E7%AC%A6%E4%B8%B2%E7%BC%96%E7%A0%81&page=1">https://www.php.cn/link/b9bfa33d7db02d23b9ee762672dbf850?q=PHP+%E5%AD%97%E7%AC%A6%E4%B8%B2%E7%BC%96%E7%A0%81&page=1</a>
?>

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！