php 8.6可让dto实现jsonserializable,在jsonserialize中显式返回对外字段,从而保持稳定的json结构并隐藏内部属性。输出契约应使用字段白名单,不依靠把整个对象强制转数组来推测哪些字段可以公开。

PHP手册中的PHP: JsonSerializable - Manual
把内部存储与公开字段分开
<?php
final class UserView implements JsonSerializable {
public function __construct(
private int $id,
private string $displayName,
private string $internalNote
) {}
public function jsonSerialize(): array {
return ['id'=>$this->id,'display_name'=>$this->displayName];
}
}
$view=new UserView(42,'Ada','仅供后台使用');
header('Content-Type: application/json; charset=UTF-8');
echo json_encode($view,
JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR);
PHP手册中的PHP: JsonSerializable::jsonSerialize - Manual
确认JSON形状不会随内部重构改变
示例对外只包含id和display_name,internalNote不会因为被新增、改名或赋值就自动进入响应。不要在jsonSerialize里返回$this,否则可能形成递归;嵌套对象也应有明确的公开表示。
错误处理放在响应边界
JSON_THROW_ON_ERROR能让无效编码、递归等问题进入异常处理。实际控制器应在输出前完成编码,再由统一错误层记录安全信息并返回合适状态,不输出半段JSON或直接打印内部异常细节。
使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。
字段白名单仍需结合权限
不同调用方可能只能看到不同信息,应构造对应的视图对象。JsonSerializable只定义序列化结果,不会替代数据访问权限,也不会阻止业务代码主动把敏感值放进白名单。


















