ThinkPHP5怎么创建API模块_ThinkPHP5创建API模块流程【指南】-ThinkPHP-PHP中文网

thinkphp 5.1 中创建 api 模块最稳妥方式是手动建目录+正确命名空间+显式配置路由，因 php think build --module api 命令仅生成空目录和基础控制器，不创建 model/validate/route.php、不设 app\api\controller 命名空间、不配置 json 返回，易致 classnotfoundexception 或 html 错误响应。

thinkphp5怎么创建api模块_thinkphp5创建api模块流程【指南】

直接结论：ThinkPHP 5.1 中创建 API 模块，最稳妥的方式是手动建目录 + 正确命名空间 + 配置路由，而不是依赖 php think build --module api 命令——该命令在 5.1 版本中不保证生成完整结构，尤其缺 model、validate 和模块级 route.php。

为什么不能只用 `php think build --module api`

这个命令在 TP5.1 中仅创建空的 application/api/ 目录和基础控制器骨架，但不会：

自动创建 application/api/model/、application/api/validate/ 等子目录
生成模块专属的 application/api/route.php
设置命名空间前缀为 app\api\controller（它可能生成成 app\controller，导致类找不到）
适配 JSON 默认返回（default_return_type 仍为 html）

结果就是访问 /api/index 报错 ClassNotFoundException 或返回 HTML 页面而非 JSON。

手动创建 API 模块的四步实操

以新建 api 模块为例，路径为 d:\php\ht\application\api\：

在 application/ 下新建文件夹 api（必须全小写，不能是 Api 或 API）
在 api/ 内依次创建子目录：controller、model、validate、config、route.php

在 api/controller 下新建 Index.php，内容需包含正确命名空间：

<?php namespace app\api\controller;
use think\Controller;
class Index extends Controller
{
    public function index()
    {
        return json(['code' => 0, 'msg' => 'API is ready']);
    }
}

确保 application/config.php 中已开启路由：'url_route_on' => true，并设返回类型为 JSON：'default_return_type' => 'json'

路由配置必须独立写进 `application/api/route.php`

TP5.1 的模块级路由不会自动加载，必须显式引入。在 application/api/route.php 中写：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

use think\Route;
Route::group('api', function () {
    Route::get('test', 'api/Index/index');
    Route::post('user', 'api/User/add');
});

然后在 application/route.php 顶部加入加载语句：

if (is_file(APP_PATH . 'api' . DS . 'route.php')) {
    include APP_PATH . 'api' . DS . 'route.php';
}

不这么做，/api/test 就会 404；用 Route::domain() 是另一套方案，但需要额外配域名或 host，不推荐新手起步用。

常见 404 / 500 场景和对应检查点

访问 /api/test 出现问题时，按顺序排查：

URL 路径是否带了入口文件？例如用了 index.php/api/test 却没开 pathinfo —— 检查 public/.htaccess（Apache）或 nginx.conf（Nginx）是否支持 PATH_INFO
控制器类名是否与文件名一致？Index.php → 类必须叫 Index，不是 ApiController
命名空间是否漏写 app\api\controller？少一个层级就会触发自动加载失败
application/api/route.php 是否被 application/route.php 包含？没包含就等于没注册路由
是否误把控制器放在 application/controller/ 下？模块控制器必须严格落在 application/api/controller/