萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 解析含中文 URL 路徑:rawurlencode 逐段編碼方案

前言

URL 路徑包含中文時,直接請求會導致 404 或亂碼。RFC 3986 規定路徑段需百分號編碼。本文提供 urlConvert() 函數,僅對路徑部分逐段 rawurlencode(),保留協議、域名、查詢字串不變。

問題場景

// 原始 URL (路徑含中文)
$url = 'https://example.com/搜索/PHP教程/第1頁?sort=desc';
// 直接 file_get_contents/curl 會失敗或返回錯誤頁面

解決方案:逐段編碼路徑

<?php
/**
 * 轉換 URL 中文路徑為合法編碼
 * @param string $url 原始 URL
 * @return string 編碼後 URL
 */
function urlConvert($url) {
    $parts = parse_url($url);
    if (!$parts || empty($parts['path'])) return $url;

    // 分割路徑段
    $segments = explode('/', $parts['path']);
    $encodedSegments = [];
    foreach ($segments as $seg) {
        if ($seg === '') {
            $encodedSegments[] = ''; // 保留前導/尾隨斜線
        } else {
            // rawurlencode: 依 RFC 3986 編碼,空格編為 %20 (非 +)
            $encodedSegments[] = rawurlencode($seg);
        }
    }

    // 重組 URL
    $newPath = implode('/', $encodedSegments);
    $newUrl = $parts['scheme'] . '://' . $parts['host'];
    if (isset($parts['port'])) $newUrl .= ':' . $parts['port'];
    $newUrl .= $newPath;
    if (isset($parts['query'])) $newUrl .= '?' . $parts['query'];
    if (isset($parts['fragment'])) $newUrl .= '#' . $parts['fragment'];

    return $newUrl;
}

// 測試
$url = 'https://example.com/搜索/PHP教程/第1頁?sort=desc';
echo urlConvert($url);
// 輸出: https://example.com/%E6%90%9C%E7%B4%A2/PHP%E6%95%99%E7%A8%8B/%E7%AC%AC1%E9%A0%81?sort=desc
?>

關鍵函數差異

函數空格編碼適用場景編碼字符集
rawurlencode()%20路徑、Fragment、標準遵循RFC 3986
urlencode()+查詢字串 (application/x-www-form-urlencoded)RFC 1866
rawurldecode()解碼 %20配對 rawurlencode
urldecode()解碼 + 和 %20配對 urlencode

完整請求範例

<?php
$originalUrl = 'https://api.example.com/用戶/張三/訂單?status=paid';
$safeUrl = urlConvert($originalUrl);

$ch = curl_init($safeUrl);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    // 處理數據...
}
?>

現代替代:http_build_url (pecl_http)

<?php
// 需安裝 pecl_http 擴展
$url = http_build_url('https://example.com', [
    'path' => ['搜索', 'PHP教程', '第1頁'],
    'query' => ['sort' => 'desc']
], HTTP_URL_STRIP_ALL);
// 自動處理編碼與組裝
?>

注意事項

  • 僅編碼 路徑段,查詢字串參數值應用 urlencode()(或 http_build_query() 自動處理)。
  • 域名中文需用 Punycode (idn_to_ascii()) 轉換,而非 percent-encoding。
  • 雙重編碼風險:確保輸入 URL 未經編碼,或先 rawurldecode() 再重新編碼。
copyright © 萬盛學電腦網 all rights reserved