php 8.5.7 内置 uri 扩展但需手动启用：在 php.ini 中添加 extension=uri 并重启服务；启用后可使用 uri 类安全解析、构造及规范化 url，支持 rfc 3986 和 whatwg 标准。

PHP 8.5.7 中的 URI 扩展已内置，无需单独安装，但默认未启用——它不像 mbstring 或 openssl 那样开箱即用，必须在 php.ini 中显式开启才能使用。只要配置正确，你就能获得符合 RFC 3986 和 WHATWG 标准的安全 URL 解析与构造能力。

确认 PHP 版本并检查 URI 扩展是否可用

先验证环境是否就绪：

• 运行 php -v，确认输出包含 8.5.7
• 执行 php -m | grep uri，若无输出，说明尚未启用（不是缺失）
• 运行 php --ri uri，若提示“Extension 'uri' not present”，也表明未加载

启用 URI 扩展（关键一步）

URI 扩展是 PHP 8.5+ 的内置扩展，但需手动启用：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 找到你的 php.ini 文件（用 php --ini 查看路径）
• 在文件末尾添加一行：extension=uri
• 保存后重启 Web 服务（如 Apache/Nginx）或 CLI 环境（终端需重新打开）
• 再次运行 php -m | grep uri，应看到 uri 输出

基础用法：创建和读取 URI 对象

启用后即可直接使用 Uri 类（位于全局命名空间）：

• 解析 URL：$uri = new Uri("https://user:pass@example.com:8080/path/to?k=v#section");
• 安全获取组件（自动解码）：$uri->getHost() → "example.com"；$uri->getPath() → "/path/to"；$uri->getQuery() → "k=v"
• 注意：$uri->getFragment() 返回解码后的 "section"，而非原始 "section" 或 "sec%74ion"

安全修改与规范化（推荐场景）

URI 对象是不可变的，所有修改都返回新实例，避免意外污染：

• 添加查询参数：$new = $uri->withQueryValue('token', 'abc123');
• 替换主机（自动处理 IDNA）：$new = $uri->withHost('例子.中国'); → 支持国际化域名
• 清除敏感信息：$public = $uri->withoutUserInfo(); → 移除 user:pass@
• 生成标准化 URL：(string) $uri 自动按 WHATWG 规则归一化（如合并 ./、解码安全字符）

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！