php 8.6的json接口可用rfc 9457的application/problem+json返回机器可读错误,把http状态与问题详情中的status保持一致。字段校验错误可作为扩展成员返回,但不要暴露异常堆栈、sql、认证信息或内部文件路径。

RFC原文中的RFC 9457
封装一个明确的422响应
<?php
function validationProblem(array $errors): never {
$clean=[];
foreach (['name','email'] as $field) {
if (isset($errors[$field]) && is_string($errors[$field])) {
$clean[$field]=$errors[$field];
}
}
$problem=[
'type'=>'about:blank',
'title'=>'请求内容无法处理',
'status'=>422,
'detail'=>'请按字段提示修改输入。',
'errors'=>$clean,
];
$json=json_encode($problem,JSON_THROW_ON_ERROR|JSON_UNESCAPED_UNICODE);
http_response_code(422);
header('Content-Type: application/problem+json; charset=utf-8');
header('Cache-Control: no-store');
echo $json;
exit;
}
// 在现有字段校验失败分支中调用;这里演示一项固定校验结果。
validationProblem(['name'=>'名称不能为空']);
PHP手册中的json_encode
标准成员与扩展成员分清楚
type、title、status、detail和instance是标准定义的成员,errors是本接口自行约定的扩展,客户端不能假定所有RFC 9457接口都有这一结构。about:blank表示没有超出HTTP状态语义的专门问题类型,title可作语言本地化;需要稳定业务类型时,应另外定义有文档的类型URI。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
不要让错误响应带出内部信息
字段清单和提示应由应用控制,不能直接把任意异常消息塞进detail。示例没有返回用户提交的原始值。认证失败、权限不足、请求格式错误与服务故障应分别使用相应HTTP状态,不把所有失败统一写为422,也不能只在JSON里改状态而仍返回HTTP 200。


















