API 模式概述
本节说明何时选择API模式、特点与目录/配置要点,并引导到路由与API参考,仅适用于API模式。
API模式是Anon Framework的默认模式,面向纯接口开发,所有响应为JSON,无模板渲染,适合对接前端、移动端或作为微服务。
何时选择 API 模式
- 只提供 REST/JSON 接口,不直接输出 HTML 页面
- 前端为独立 SPA(Vue、React 等)或移动端,由前端负责页面与路由
- 需要轻量、低内存占用、高并发的接口服务
特点概览
- 响应格式:统一 JSON,
Content-Type: application/json - 路由:基于
app/Router/目录或useRouter.php,支持自动路由 - 无模板:不加载主题与模板引擎,错误页也为 JSON
- 认证与安全:内置 Token、CSRF、验证码等,见 用户认证、安全功能
目录与配置要点
- 模式配置:
server/.env.php中ANON_APP_MODE为api(或server/app/useApp.php中app.mode为api) - 路由目录:
server/app/Router/,文件名与目录结构映射为 URL 路径 - 应用配置:
server/app/useApp.php中可配置autoRouter、token、security等
