You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

75 lines
2.2 KiB

<?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,
],
];