php 8.6弃用了http_build_query把对象静默当作属性数组的用法,包括嵌套数据中的对象。生成查询串前,最好按业务协议把dto明确映射成数组;只转换最外层仍可能留下嵌套对象和新的弃用提示。

PHP官方文档中的DTO查询参数相关说明。 图源:PHP Documentation Group(CC BY3.0)。
让DTO提供明确的字段映射
<?php
final class PageOptions {
public function __construct(public int $number) {}
}
final class SearchFilter {
public function __construct(public string $query, public PageOptions $page) {}
public function toQueryData(): array {
if ($this->page->number < 1 || strlen($this->query) > 200) {
throw new InvalidArgumentException('查询条件不符合约定');
}
return ['q' => $this->query, 'page' => ['number' => $this->page->number]];
}
}
$filter = new SearchFilter('中文资料', new PageOptions(2));
$query = http_build_query($filter->toQueryData(), '', '&', PHP_QUERY_RFC3986);
echo $query, PHP_EOL;显式决定Stringable与空值
http_build_query不会因为一个对象实现__toString就自动按字符串处理;确实需要字符串表示时,应在映射中主动转换。null、空数组、布尔值及列表索引的输出规则也要与接收端约定,不要先把所有值都转换成字符串来消除类型差异。
不要把任意对象递归展开
get_object_vars只能取得当前作用域可见属性,直接通用递归还可能遇到循环引用、私有数据和不应传出的内部状态。示例只映射固定字段及固定嵌套结构,不把整个对象图暴露为请求参数。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP 8.6升级说明中的相关弃用条目。 图源:PHP Documentation Group(CC BY3.0)。
本例输出的是查询串,不负责选择目标主机或发起HTTP请求。把它嵌入HTML属性时还需对最终URL进行HTML转义,不能把参数编码当成页面输出转义。8.6迁移的核心是先建立数据协议,再生成编码结果。


















