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.
 

57 lines
1.8 KiB

<?php
declare(strict_types=1);
/**
* Index.php
* Created by PhpStorm.
* Date: 2026/10/18
* Time: 03:55
* Author: qian.guo
* E-mail: yiyezhiqiutel@gmail.com
*/
namespace app\index\controller;
use app\BaseController;
/**
* 默认应用首页
*
* 为什么需要这个应用:
* 多应用模式要求每个 URL 第一段是应用名。config/app.php 的 default_app 是 index,
* 所以访问域名根路径 `/` 会落到这里。没有它的话,打开域名只会得到 404,
* 而 404 又会被统一异常处理器渲染成 JSON —— 看上去像「接口不存在」,
* 很难判断是「服务活着但没首页」还是「整个服务挂了」。
*
* 为什么返回 JSON 而不是网页:
* 本项目是纯 API 后端,没有视图层(装的是骨架自带的 view/ 空目录)。
* 返回一段列出可用接口的 JSON,比返回 HTML 更能直接用于排错:
* 能打开它就证明「域名 → Nginx → PHP → 框架 → 路由 → 控制器」整条链路通了。
*/
class Index extends BaseController
{
/**
* 首页
* index
* @return \think\response\Json
*/
public function index()
{
$data = [];
$data['service'] = 'zhunxin-api';
$data['status'] = 'ok';
$data['message'] = '服务运行中,这是一个 API 服务,请访问接口';
// 列出可用入口,便于直接在浏览器里点开验证
$data['endpoints'] = [];
$data['endpoints']['health'] = '/api/v1/health';
$data['endpoints']['paper'] = '/api/v1/quiz/paper';
$data['endpoints']['submit'] = '/api/v1/quiz/submit(POST)';
return json([
'code' => config('code.success'),
'msg' => 'success',
'data' => $data
]);
}
}