贾蔷僦号为什么需要改变尽管正确解析 URL 很重要但 PHP 长期以来在标准库中并没有包含任何符合标准的解析器。虽然有 parse_url() 函数它从 PHP 4 就存在了但它不遵循任何标准并且在文档中明确说明不要用于不受信任或格式错误的 URL。尽管如此由于缺乏更好的替代方案而且它对开发者日常工作中遇到的大多数格式良好的输入似乎都能正常工作所以它被广泛使用。这可能会误导开发者认为 parse_url() 的安全问题纯粹是理论问题而不是迟早会导致问题的东西。举个例子输入 URL example.com/example/:8080/foo 根据 RFC 3986 是一个有效的 URL仅由相对路径组成。如果不针对基础 URL 解析根据 WHATWG URL 标准它是无效的。然而根据 parse_url() 的解析它是主机为 example.com、端口为 8080、路径为 /example/:8080/foo 的 URL因此在两个结果组件中都包含了 8080var_dump(parse_url(example.com/example/:8080/foo));/*array(3) {[host] string(11) example.com[port] int(8080)[path] string(18) /example/:8080/foo}*/引入新 API这在 PHP 8.5 中发生了变化。从现在开始PHP 将在新的 URI 扩展中包含符合 RFC 3986 和 WHATWG URL 标准的解析器作为标准库中始终可用的一部分。这不仅能够根据各自的标准轻松、正确、安全地解析 URL而且 URI 扩展还包含修改 URL 各个组件的功能。use Uri\Rfc3986\Uri;$url new Uri(HTTPS://thephp.foundation:443/sp%6Fnsor/);$defaultPortForScheme match ($url-getScheme()) {http 80,https 443,ssh 22,default null,};// 从 URL 中删除默认端口if ($url-getPort() $defaultPortForScheme) {$url $url-withPort(null);}// Getter 默认会规范化 URL。Raw// 变体会原样返回输入。echo $url-toString(), PHP_EOL;// 输出: https://thephp.foundation/sponsor/echo $url-toRawString(), PHP_EOL;// 输出: HTTPS://thephp.foundation/sp%6Fnsor/精心构建以持久使用在这篇文章中我们不仅想展示功能还想告诉你这个项目是如何发展的以及在 PHP 中如何完成工作以保持语言现代化成为 Web 开发的绝佳选择。新 PHP 功能背后的工作往往比表面看到的要多。我们希望提供一些见解说明为什么我们更喜欢把事情做对而不是做快。来自 PHP 基金会开发团队的 Máté Kocsis 最初在 2024 年 6 月开始讨论他关于新 URL 解析 API 的 RFC。鉴于 PHP 强大的向后兼容性承诺新 API 需要在第一次尝试时就把事情做对以便在未来十年内为 PHP 社区提供良好服务而不会引入破坏性变化。因此在将近一年的时间里PHP Internals 邮件列表上发送了 150 多封电子邮件。此外还在各种聊天室进行了多次非列表讨论。在整个过程中来自 PHP 社区的各种专家不断完善 RFC。他们讨论了即使是看似微不足道的细节不仅要提供符合标准的实现还要提供一个干净、健壮的 API引导开发者为他们的用例找到正确的解决方案。我们还提前规划确保新的 URI 扩展及其专用的 Uri 命名空间为在未来版本的 PHP 中添加额外的 URI/URL 相关功能提供了清晰的路径。RFC 最终在 2025 年 5 月进行投票并以 30:1 的投票结果获得通过。但工作并没有就此停止提议的 API 还必须实现和审查。Máté 没有构建一个 PHP 特定的解决方案而是选择站在巨人的肩膀上选择了两个库来完成繁重的工作。uriparser 库提供 RFC 3986 解析器而 Lexbor 库已被 PHP 8.4 的新 DOM API 使用提供 WHATWG 解析器。开源协作作为集成的一部分Máté 和 PHP 基金会与上游维护者合作在各自的库中包含缺失的功能。例如这两个库都不包含廉价复制内部数据结构的功能而这对于支持在尝试使用所谓的 with-er 方法例如 -withPort(8080)修改各个组件时克隆表示已解析 URL 的只读 PHP 对象是必需的。uriparser 库也不包含任何用于修改已解析 URL 组件的函数。所有这些功能现在都可以在上游库中供所有人使用和受益。Máté 的 PHP 实现的审查和测试由 PHP 社区贡献者 Niels Dossche 和 Ignace Nyamagana Butera 进行。这包括审查和测试已添加到两个上游库的新功能。TidewaysPHP 基金会的创始成员和白银赞助商也赞助了工程时间他们的贡献以 Tim Düsterhus 的形式出现。在审查和测试期间这些审查者在上游库中发现了几个预先存在的 bug。他们向上游维护者 Sebastian Pippinguriparser和 Alexander BorisovLexbor提交了修复他们迅速审查并应用了这些修复。立即测试这项工作得到了回报PHP 的新 URI 扩展不仅有一个而是两个功能丰富且符合标准的 URI 实现现在可以在 PHP 8.5 RC 1 中完全测试。来自 PHP 基金博客