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);
// 處理數據...
}
?>
<?php
// 需安裝 pecl_http 擴展
$url = http_build_url('https://example.com', [
'path' => ['搜索', 'PHP教程', '第1頁'],
'query' => ['sort' => 'desc']
], HTTP_URL_STRIP_ALL);
// 自動處理編碼與組裝
?>
urlencode()(或 http_build_query() 自動處理)。idn_to_ascii()) 轉換,而非 percent-encoding。rawurldecode() 再重新編碼。