parse_url 返回 false 的常见原因是网址无协议（如 http://）或输入为空字符串、null；它不自动补协议，仅做结构拆解，IPv6 和中文域名需特殊处理，query 不自动解析，需配合 parse_str 或 PHP 8.4+ 新标志。
parse_url 返回 false 的常见原因
不是网址格式不对，就是传了空字符串或 null。parse_url 对输入极其敏感：开头没 http:// 或 https://，又没带协议的伪协议（如 ftp://），就直接返回 false。比如传 "example.com/path" 或 ""，结果都是 false，而不是数组。
检查前务必先用 is_string 和 trim 过滤：
if (!is_string($url) || trim($url) === '') {
return [];
}
$url = trim($url);
$result = parse_url($url);
if ($result === false) {
return [];
}
- 别指望它自动补
http://—— 它不做任何修复，只做结构拆解 - IPv6 地址写法（如
[::1]）必须带方括号，否则解析失败 - 中文域名需提前用
idn_to_ascii转成 punycode，否则parse_url会崩
提取 query 参数时，parse_url 不解码，也不解析键值对
parse_url 只负责把 URL 拆成 scheme、host、path、query 等字段，query 字段还是原始字符串，比如 "name=%E4%BD%A0%E5%A5%BD&age=25"，它不会帮你调用 urldecode，更不会转成数组。
要拿到键值对，得自己处理 query 字段：
立即学习“PHP免费学习笔记（深入）”；
$parsed = parse_url($url);
if ($parsed && isset($parsed['query'])) {
parse_str($parsed['query'], $params); // 注意：$params 是引用写入
}
-
parse_str会把+当空格，但不会处理%2B—— 两者语义不同，别混用 - 如果 query 里有重复 key（如
a=1&a=2），parse_str默认只保留最后一个，要用parse_str($q, $arr)+ 手动分拆才能保留全部 - 不要在
parse_str前对query调urldecode—— 它内部已经做了，重复解码会导致乱码
PHP 8.4+ 的 PARSE_URL_QUERY_AS_ARRAY 标志真有用吗？
有用，但非常有限。这个新标志只影响 query 字段是否被自动解析为关联数组，且仅支持最简单的 k=v&k2=v2 格式；遇到嵌套（如 user[name]=jack）、数组语法（ids[]=1&ids[]=2）或无等号参数（debug），它照样返回原始字符串。
用法示例：
$parsed = parse_url($url, PHP_URL_QUERY | PARSE_URL_QUERY_AS_ARRAY);
- 返回值不是完整数组，而是只含
query的扁平数组，其他字段（host、path）全丢了 - 不兼容旧版本 PHP，线上环境没升到 8.4 别写死这个常量
- 它不替代
parse_str，只是多一种轻量取 query 的方式，别高估它的能力
pathinfo 和 parse_url 在处理路径时的根本区别
pathinfo 是文件系统视角，parse_url 是 URL 结构视角。同一个字符串 "/api/v1/users?id=123"，pathinfo 会把它当本地路径拆出 dirname、basename、extension；而 parse_url 必须包裹在完整 URL 中（如 "https://a.com/api/v1/users?id=123"）才有效，且只认 path 和 query 的边界（即第一个 ?）。
- 别对裸路径（如
/foo/bar?x=1）直接调parse_url—— 缺协议会返回false - 想安全提取 path 部分，先拼个假协议：
parse_url('http://a'.$path)，但要注意$path开头不能是//（会被当成协议相对 URL） -
pathinfo的PATHINFO_FILENAME对/api/v1/返回空，而parse_url的path字段原样保留末尾斜杠 —— 行为差异直接影响路由匹配逻辑
parse_url 返回值类型，直接访问 $res['query'] 导致 Notice；还有人把 parse_str 当万能 query 解析器，忽略了它对复杂格式的无力感。URL 解析看着简单，细节全是坑。 
