ThinkPHP8.0怎么创建接口专用控制器-ThinkPHP-PHP中文网

thinkphp 8.0 接口控制器需严格遵循命名规范（驼峰、首字母大写、文件与类名一致）、显式路由绑定（如 route::get('api/user/list', [usercontroller::class, 'list'])）及响应约定（return 数组或 json()，禁用 echo/exit），推荐使用 api/ 子目录隔离接口域，可选继承 basecontroller 统一处理鉴权等逻辑。

thinkphp8.0怎么创建接口专用控制器

ThinkPHP 8.0 创建接口专用控制器，核心是“命名规范 + 路由绑定 + 响应约定”，不依赖特殊基类，但需明确区分用途和返回格式。

控制器文件与类名必须严格匹配

在 app/controller/ 目录下新建 PHP 文件，文件名首字母大写、驼峰命名，且与类名完全一致：

✅ 正确示例：app/controller/Api/UserController.php，类定义为 class UserController
✅ 推荐结构化路径：用子目录区分模块，如 Api/ 表示纯接口域，避免与前台页面控制器混用
❌ 错误写法：usercontroller.php（小写）、user_controller.php（下划线）、class usercontroller（类名未大写）

方法要 public、只 return、不 echo/exit

接口控制器方法必须返回数据，框架自动处理序列化。禁止手动输出或中断流程：

PHP 8.5.12 RC 1

PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

✅ 返回 JSON：return json(['code' => 0, 'data' => $list]);
✅ 返回数组（框架自动转 JSON）：return ['code' => 0, 'msg' => 'ok'];
✅ 支持类型声明（建议启用 strict_types）：public function detail(int $id): array { ... }
❌ 禁止：echo json_encode(...); exit; 或 dump()、die()

路由必须显式注册，不能靠隐式访问

TP8 默认关闭兼容模式，/user/index 这类路径不会自动匹配，必须在 route/app.php 中明确定义：

✅ 推荐写法（推荐控制器方法绑定）：Route::get('api/user/list', [app\controller\Api\UserController::class, 'list']);
✅ 支持参数：Route::get('api/user/:id', [app\controller\Api\UserController::class, 'detail']);
⚠️ 注意：Route::get('user/:id', 'UserController@detail') 是 TP6 风格，在 TP8 中已失效，会 404

可选：继承公共基类统一处理逻辑

若多个接口需共享鉴权、跨域、参数校验等，可建一个基础控制器，其他接口控制器继承它：

新建 app/controller/Api/BaseController.php，内容如：

namespace app\controller\Api;<br>use think\Controller;<br>class BaseController extends Controller<br>{<br>  protected function initialize()<br>  {<br>    // 统一 token 验证、日志记录等<br>  }<br>}