<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* code.php
|
|
* Created by PhpStorm.
|
|
* Date: 2026/10/17
|
|
* Time: 09:40
|
|
* Author: qian.guo
|
|
* E-mail: yiyezhiqiutel@gmail.com
|
|
*/
|
|
|
|
/*
|
|
| 接口状态码
|
|
|
|
|
| 取值规则来自《代码规范.md》第七节:成功 200 / 业务失败 400 / 未登录 401 / 系统错误 500
|
|
| 业务代码里的 code 一律从这里取:config('code.success') 等,不要硬编码数字
|
|
|
|
|
| msg 不放在这里:规范第七节的示例是把中文原因直接写在控制器里('打卡点不存在')
|
|
| 集中到配置会变成两处定义同一个字符串,改动时容易漏一处
|
|
*/
|
|
|
|
return [
|
|
// 语义层状态码
|
|
'success' => 200,
|
|
'fail' => 400,
|
|
'unauthorized' => 401,
|
|
'error' => 500,
|
|
|
|
/*
|
|
| 细分业务码
|
|
|
|
|
| 规范只定义 200/400/401/500 四个码,业务失败统一返回 400 + 中文 msg
|
|
| 但前端若只能靠匹配中文文案来分支,改一次文案就会静默失效
|
|
| 因此把机器可读的细分码放进 data.err_code(规范允许「可带 data 说明细节」)
|
|
| 前端优先用 err_code 分支,msg 只用于文案展示
|
|
|
|
|
| 分段:10000 通用 / 20000 用户 / 30000 测评 / 40000 报告 / 50000 分享
|
|
*/
|
|
'err' => [
|
|
// 通用
|
|
'param' => 10001,
|
|
'unauthed' => 10002,
|
|
'forbidden' => 10003,
|
|
'too_many_request' => 10004,
|
|
'server_busy' => 10005,
|
|
'not_found' => 10006,
|
|
'method_not_allow' => 10007,
|
|
|
|
// 用户
|
|
'user_not_found' => 20001,
|
|
'user_banned' => 20002,
|
|
'wx_code_invalid' => 20003,
|
|
'wx_api_error' => 20004,
|
|
'login_failed' => 20005,
|
|
|
|
// 测评
|
|
'paper_not_found' => 30001,
|
|
'paper_offline' => 30002,
|
|
'session_not_found' => 30003,
|
|
'session_not_own' => 30004,
|
|
'quiz_unfinished' => 30005,
|
|
'quiz_duplicate' => 30006,
|
|
'score_failed' => 30007,
|
|
|
|
// 报告
|
|
'result_not_found' => 40001,
|
|
'report_locked' => 40002,
|
|
|
|
// 分享
|
|
'share_invalid' => 50001,
|
|
'share_expired' => 50002,
|
|
'share_limit' => 50004,
|
|
],
|
|
];
|