<?php
declare(strict_types=1);

/**
 * 控制器基类
 * 统一 JSON 输出规范，并提供 callBefore/callEnd 钩子约定
 */
abstract class Action
{
    /** 当前请求参数，由 Mvc::dispatch() 注入 */
    protected array $request = [];

    /**
     * 由 Mvc::dispatch() 调用，注入当前请求参数
     */
    public function setRequest(array $request): void
    {
        $this->request = $request;
    }

    /**
     * 成功响应并终止程序
     */
    protected function success(mixed $data = null, string $msg = ''): void
    {
        $this->json(0, $data, $msg);
    }

    /**
     * 失败响应并终止程序
     * @param int $code 非 0 的错误代码
     */
    protected function error(int $code, string $msg = ''): void
    {
        if ($code === 0) {
            throw new MvcException('0 为成功代码，不能用于错误响应');
        }
        $this->json($code, null, $msg);
    }

    /**
     * 输出统一格式的 JSON 并终止程序
     * 响应结构: {"code":0,"data":{...},"msg":""}
     */
    protected function json(int $code, mixed $data = null, string $msg = ''): void
    {
        header('Content-Type: application/json; charset=utf-8');
        echo json_encode([
            'code' => $code,
            'data' => $data,
            'msg'  => $msg,
        ], JSON_UNESCAPED_UNICODE);
        exit();
    }
}