如何正确地在 PHP 中对字符串进行 URL 编码？

Question

我正在创建一个搜索页面，您可以在其中键入搜索查询并将表单提交给search.php?query=your query。什么 PHP 函数是最好的，我应该使用它来编码/解码搜索查询？

Answer 1

根据您要执行的 RFC 标准编码类型，或者如果您需要自定义编码，您可能需要创建自己的类。

/**
 * UrlEncoder make it easy to encode your URL
 */
class UrlEncoder{
    public const STANDARD_RFC1738 = 1;
    public const STANDARD_RFC3986 = 2;
    public const STANDARD_CUSTOM_RFC3986_ISH = 3;
    // add more here

    static function encode($string, $rfc){
        switch ($rfc) {
            case self::STANDARD_RFC1738:
                return  urlencode($string);
                break;
            case self::STANDARD_RFC3986:
                return rawurlencode($string);
                break;
            case self::STANDARD_CUSTOM_RFC3986_ISH:
                // Add your custom encoding
                $entities = ['%21', '%2A', '%27', '%28', '%29', '%3B', '%3A', '%40', '%26', '%3D', '%2B', '%24', '%2C', '%2F', '%3F', '%25', '%23', '%5B', '%5D'];
                $replacements = ['!', '*', "'", "(", ")", ";", ":", "@", "&", "=", "+", "$", ",", "/", "?", "%", "#", "[", "]"];
                return str_replace($entities, $replacements, urlencode($string));
                break;
            default:
                throw new Exception("Invalid RFC encoder - See class const for reference");
                break;
        }
    }
}

使用示例：

$dataString = "https://www.google.pl/search?q=PHP is **great**!&id=123&css=#kolo&email=me@liszka.com)";

$dataStringUrlEncodedRFC1738 = UrlEncoder::encode($dataString, UrlEncoder::STANDARD_RFC1738);
$dataStringUrlEncodedRFC3986 = UrlEncoder::encode($dataString, UrlEncoder::STANDARD_RFC3986);
$dataStringUrlEncodedCutom = UrlEncoder::encode($dataString, UrlEncoder::STANDARD_CUSTOM_RFC3986_ISH);

将输出：

string(126) "https%3A%2F%2Fwww.google.pl%2Fsearch%3Fq%3DPHP+is+%2A%2Agreat%2A%2A%21%26id%3D123%26css%3D%23kolo%26email%3Dme%40liszka.com%29"
string(130) "https%3A%2F%2Fwww.google.pl%2Fsearch%3Fq%3DPHP%20is%20%2A%2Agreat%2A%2A%21%26id%3D123%26css%3D%23kolo%26email%3Dme%40liszka.com%29"
string(86)  "https://www.google.pl/search?q=PHP+is+**great**!&id=123&css=#kolo&email=me@liszka.com)"

* 了解有关 RFC 标准的更多信息： https://datatracker.ietf.org/doc/rfc3986/ 和urlencode vs rawurlencode?

Answer 2

这是我的用例，它需要大量的编码。也许你认为它做作，但我们在生产中运行它。巧合的是，这涵盖了所有类型的编码，因此我将其作为教程发布。

用例说明

有人刚刚在我们的网站上购买了预付礼品卡（“代币”）。令牌有相应的 URL 来兑换它们。该客户希望通过电子邮件将 URL 发送给其他人。我们的网页包含一个mailto 链接，可让他们这样做。

PHP 代码

// The order system generates some opaque token
$token = 'w%a&!e#"^2(^@azW';

// Here is a URL to redeem that token
$redeemUrl = 'https://httpbin.org/get?token=' . urlencode($token);

// Actual contents we want for the email
$subject = 'I just bought this for you';
$body = 'Please enter your shipping details here: ' . $redeemUrl;

// A URI for the email as prescribed
$mailToUri = 'mailto:?subject=' . rawurlencode($subject) . '&body=' . rawurlencode($body);

// Print an HTML element with that mailto link
echo '<a href="' . htmlspecialchars($mailToUri) . '">Email your friend</a>';

注意：以上假设您正在输出到text/html 文档。如果您的输出媒体类型是text/json，那么只需使用$retval['url'] = $mailToUri;，因为输出编码由json_encode() 处理。

测试用例

1. 在 PHP 测试站点上运行代码（我应该在这里提到一个规范的代码吗？）
2. 点击链接
3. 发送电子邮件
4. 获取电子邮件
5. 点击该链接

你应该看到：

"args": {
  "token": "w%a&!e#\"^2(^@azW"
}, 

当然这是上面$token的JSON表示。

Answer 3

你可以使用 PHP 的 URL 编码函数

rawurlencode() 

功能

ASP 有

Server.URLEncode() 

功能

在 JavaScript 中你可以使用

encodeURIComponent() 

功能。

Answer 4

对于 URI 查询，使用 urlencode/urldecode；对于其他任何事情，请使用rawurlencode/rawurldecode。

urlencode和rawurlencode的区别在于

• urlencode根据application/x-www-form-urlencoded编码（空格用+编码）而
• rawurlencode 按照普通的Percent-Encoding 编码（空格用%20 编码）。

Answer 5

狡猾地命名为urlencode() 和urldecode()。

但是，您不需要对出现在$_POST 和$_GET 中的变量使用urldecode()。