Phalcon需手动封装JSON响应：定义统一结构{code,msg,data}，基类提供json()方法设状态码/Content-Type并send()终止流程，全局捕获异常转JSON，禁用BOM。
Phalcon 的 Response 组件本身不内置“格式化器”概念（如 Yii 的 formatters 配置），也不像 Laravel 那样自动识别控制器返回数组并转 JSON。要实现 AJAX 请求统一返回标准 JSON 结构，需手动封装响应逻辑，核心是控制输出内容、HTTP 状态码和响应头。
统一 JSON 响应结构设计
建议采用固定字段约定，例如：{ "code": 0, "msg": "success", "data": [...] }。code 为业务状态码（0 表示成功），msg 是提示信息，data 是实际数据体。避免混用 HTTP 状态码和业务 code，两者职责分离：HTTP 码表征传输/服务层结果（如 200、404、500），code 表示业务逻辑结果（如 1001 用户不存在）。
- 所有 AJAX 接口入口（如控制器 action）应返回该结构，不直接 echo 或 return 原始数组
- 在基类控制器中提供
json($data, $code = 0, $msg = 'success', $status = 200)方法，内部调用$this->response->setStatusCode($status)和$this->response->setContentType('application/json', 'UTF-8') - 确保
$data可被json_encode()序列化；若含对象，需实现JsonSerializable或提前转换
设置 Content-Type 与字符编码
Phalcon 不会自动设置 Content-Type: application/json; charset=utf-8，必须显式声明，否则前端 fetch().json() 或 jQuery dataType: 'json' 可能解析失败或降级为字符串。
- 在输出前调用：
$this->response->setContentType('application/json', 'UTF-8'); - UTF-8 编码不可省略，尤其含中文时，否则中文变
\uXXXX或乱码 - 该方法必须在任何输出（包括空格、BOM、
echo、var_dump）之前执行，否则报 “headers already sent”
安全终止响应流程
Phalcon 不强制终止脚本执行，若后续代码继续运行并输出内容，JSON 将被污染（如多出空白或错误信息），导致前端解析失败。
- 在
json()方法末尾加return $this->response->send();—— 这会立即发送响应并结束当前请求周期 - 避免使用
exit或die，因它绕过 Phalcon 生命周期（如事件、钩子、日志），send()是框架推荐方式 - 检查文件是否含 BOM：UTF-8 with BOM 的 PHP 文件会在响应开头插入不可见字节，破坏 JSON 格式；用编辑器保存为 “UTF-8 无 BOM”
异常与错误的 JSON 化处理
默认情况下，未捕获异常会触发 Phalcon 默认错误页（HTML），对 AJAX 不友好。需全局拦截并转为 JSON 错误响应。
- 在
index.php或 DI 容器中注册异常处理器：$di->set('dispatcher', function () { ... });并监听dispatch:beforeException事件 - 在事件回调中判断请求是否为 AJAX（如检查
$_SERVER['HTTP_X_REQUESTED_WITH'] === 'XMLHttpRequest'），若是，则构造{ "code": -1, "msg": "Server error", "data": null }并用Response::setStatusCode(500)->setContentType(...)->setContent(...)->send() - 验证失败等业务异常，也应主动 throw 自定义异常，并在统一处理器中映射为对应 code 和 msg，而非依赖 PHP 错误输出
