<?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
|
|
]);
|
|
}
|
|
}
|