Files

T

nepiedg 166940d5a6 Initial commit: ThinkPHP refactor (tp)

Made-with: Cursor

2026-04-02 02:13:12 +00:00

6.4 KiB

Raw Blame History

常见问题 FAQ

1. 安装和配置

Q: 如何修改默认应用？

A: 编辑 config/app.php 文件，修改 default_app 配置：

'default_app' => 'api',

Q: 如何配置数据库？

A: 编辑 .env 文件，修改数据库连接信息：

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = tp_api
USERNAME = root
PASSWORD = your_password
HOSTPORT = 3306
CHARSET = utf8mb4

Q: 如何开启调试模式？

A: 在 .env 文件中设置：

APP_DEBUG = true

2. 路由和访问

Q: 如何访问 API 接口？

A: URL 格式为 http://域名/应用名/控制器/方法

示例：http://localhost:8000/api/index/index
或使用路由：http://localhost:8000/api/index（需配置路由）

Q: 如何添加新的路由？

A: 在 route/api.php 文件中添加路由规则：

Route::get('user/profile', 'api.User/profile');
Route::post('user/update', 'api.User/update');

Q: 如何设置路由参数？

A: 使用 :参数名 格式：

Route::get('user/:id', 'api.User/detail');

3. 控制器开发

Q: 如何创建新的控制器？

手动创建：在 app/api/controller/ 目录下创建 PHP 文件
使用命令：php think make:controller api@Demo

Q: 如何返回 JSON 数据？

A: 使用基础控制器提供的方法：

// 成功响应
return $this->success($data, '操作成功');

// 失败响应
return $this->error('操作失败');

// 或使用 json() 函数
return json(['code' => 200, 'data' => $data]);

Q: 如何获取请求参数？

// GET 参数
$data = $this->request->get();

// POST 参数
$data = $this->request->post();

// 所有参数
$data = $this->request->param();

// 单个参数
$name = $this->request->param('name');

4. 数据验证

Q: 如何验证请求数据？

在控制器中直接验证：

$this->validate($data, [
    'username' => 'require|length:3,20',
    'email' => 'require|email',
]);

使用验证器：

$this->validate($data, 'app\api\validate\User.register');

Q: 如何自定义验证错误信息？

$this->validate($data, $rules, [
    'username.require' => '用户名不能为空',
    'email.email' => '邮箱格式不正确',
]);

5. 中间件

Q: 如何创建中间件？

<?php
namespace app\api\middleware;

class CheckToken
{
    public function handle($request, \Closure $next)
    {
        // 前置中间件
        $token = $request->header('token');
        if (empty($token)) {
            return json(['code' => 401, 'msg' => '未授权']);
        }

        return $next($request);
    }
}

Q: 如何使用中间件？

全局中间件：在 app/api/middleware.php 中注册
路由中间件：在路由定义中使用

Route::group('api', function () {
    Route::get('user/info', 'api.User/info');
})->middleware(\app\api\middleware\Auth::class);

6. 数据库操作

Q: 如何使用模型？

// 查询单条
$user = \app\api\model\User::find(1);

// 查询多条
$users = \app\api\model\User::where('status', 1)->select();

// 新增
$user = new \app\api\model\User;
$user->username = 'test';
$user->save();

// 或
\app\api\model\User::create([
    'username' => 'test',
    'password' => '123456',
]);

// 更新
\app\api\model\User::update(['id' => 1, 'status' => 0]);

// 删除
\app\api\model\User::destroy(1);

Q: 如何使用事务？

use think\facade\Db;

Db::startTrans();
try {
    // 数据库操作
    Db::commit();
} catch (\Exception $e) {
    Db::rollback();
}

7. 缓存

Q: 如何使用缓存？

use think\facade\Cache;

// 设置缓存
Cache::set('key', 'value', 3600);

// 获取缓存
$value = Cache::get('key');

// 删除缓存
Cache::delete('key');

8. 跨域问题

Q: 如何解决跨域问题？

项目已内置跨域中间件 CrossDomain
确保中间件已注册到 app/api/middleware.php
前端请求时需要设置正确的 headers

9. 认证授权

Q: 如何实现 Token 认证？

安装 JWT 扩展：composer require firebase/php-jwt
在登录接口生成 Token
在中间件中验证 Token
参考 app/api/middleware/Auth.php

Q: 如何实现接口签名验证？

前端按照规则生成签名
后端在中间件中验证签名
签名规则：md5(参数排序后的字符串 + 密钥 + 时间戳)

10. 性能优化

Q: 如何优化接口性能？

开启路由缓存：php think route:list
使用缓存减少数据库查询
优化 SQL 查询，避免 N+1 问题
使用队列处理耗时任务
开启 OPcache

Q: 如何开启路由缓存？

php think route:list

11. 错误处理

Q: 如何自定义错误响应？

修改 app/ExceptionHandle.php
自定义异常处理逻辑
返回 JSON 格式的错误信息

Q: 如何记录错误日志？

use think\facade\Log;

Log::error('错误信息', ['data' => $data]);
Log::info('提示信息');
Log::warning('警告信息');

12. 部署

Q: 生产环境如何部署？

关闭调试模式：APP_DEBUG = false
配置正确的数据库信息
设置正确的目录权限
配置 Nginx/Apache
开启 OPcache
使用缓存

Q: 如何设置目录权限？

chmod -R 755 /path/to/tp
chmod -R 777 /path/to/tp/runtime

13. 常见错误

Q: 提示"控制器不存在"？

检查命名空间是否正确
检查类名和文件名是否一致
检查控制器是否继承正确的基类

Q: 提示"方法不存在"？

检查方法名拼写
检查方法访问修饰符（必须是 public）
清除缓存：php think clear

Q: 数据库连接失败？

检查 .env 配置是否正确
检查数据库服务是否启动
检查防火墙设置
检查用户权限

14. 扩展功能

Q: 如何添加更多应用？

# 创建 admin 应用
mkdir -p app/admin/controller
# 然后创建控制器和配置文件

Q: 如何使用队列？

composer require topthink/think-queue
php think queue:listen

Q: 如何使用定时任务？

composer require topthink/think-cron
# 然后配置定时任务

6.4 KiB Raw Blame History Unescape Escape