ThinkPHP 8.0 静态缓存怎么设置才能缓存RESTful接口？-ThinkPHP-PHP中文网

thinkphp 8.0 不支持 restful 接口的 html 静态文件缓存，因其返回 json 而非页面；实际需用三类响应缓存：1. 框架内置请求级缓存（如 ->middleware(checkrequestcache::class) 或 $this->cache(3600)）；2. 手动数据缓存（cache::get/set，支持标签与自定义 key）；3. http 强缓存头（cache-control 等），仅适用于稳定非敏感数据。

thinkphp 8.0 静态缓存怎么设置才能缓存restful接口？

ThinkPHP 8.0 不支持对 RESTful 接口做静态缓存（即 HTML 页面级静态文件缓存），因为 RESTful 接口本质是返回 JSON 数据的动态 API，不是可生成 .html 文件的页面。所谓“静态缓存”在这里属于概念误用。你真正需要的，是 API 响应缓存（HTTP 缓存 + 框架层数据缓存），目标是减少重复计算、降低数据库压力、加快 JSON 返回速度。

下面分三类实际可行的方式说明：

✅ 1. 使用框架内置的请求级响应缓存（推荐用于 GET 类接口）

适用于 GET /api/users、GET /api/users/123 等无副作用的只读接口。

确保已启用缓存驱动（Redis 已配通，见下文验证方式）

在路由或控制器中启用中间件：

// 路由定义时启用（推荐）
Route::get('api/users', [UserController::class, 'index'])
    ->middleware(\think\middleware\CheckRequestCache::class);

或在控制器方法内显式设置缓存时长：

public function index()
{
    $this->cache(3600); // 缓存 1 小时（仅对 GET 请求生效）
    return json(['data' => Db::name('user')->select()]);
}

注意：该机制会自动根据完整 URL（含查询参数，如 ?page=2&limit=10）生成缓存 key，适合列表分页等场景。

✅ 2. 手动控制数据缓存（更灵活，推荐用于复杂逻辑）

适用于需缓存 DB 查询结果、远程调用结果等，不受 HTTP 方法限制（GET/POST 都可用）。

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

public function show($id)
{
    $key = 'api_user_' . $id;
    $user = Cache::get($key);
    if ($user === null) {
        $user = Db::name('user')->find($id);
        if ($user) {
            Cache::set($key, $user, 3600);
        }
    }
    return json($user ?: ['code' => 404, 'msg' => 'not found']);
}

✅ 支持带标签管理：Cache::tag('api_user')->set(...)，后续可批量清理
✅ 可结合业务参数构造 key（如 api_user_123_v2），避免版本冲突

✅ 3. 启用 HTTP 强缓存头（由 Nginx 或 PHP 输出）

让浏览器或 CDN 直接复用响应，跳过服务端：

在控制器中添加响应头（仅适用于内容稳定、时效要求低的接口）：

public function staticConfig()
{
    $this->response->header([
        'Cache-Control' => 'public, max-age=3600',
        'Expires'       => gmdate('D, d M Y H:i:s', time() + 3600) . ' GMT',
    ]);
    return json(['site_name' => config('app.name')]);
}

⚠️ 注意：max-age 不宜设过大，尤其当配置可能被后台修改时；敏感数据（如用户信息）禁止使用此方式。

❌ 不可行的方式（常见误区）

试图用 php think build:static 或模板静态化功能缓存 JSON 接口 → 该功能仅面向 HTML 页面，不适用 API。
把 Cache::store('file') 当作“静态缓存” → 它只是底层驱动类型，和“静态文件”无关，性能差且不支持并发清理。
依赖 .env 中 CACHE_STORE=redis 自动生效 → 必须在 config/cache.php 中完整填写 Redis 参数（host/port/database/auth 等），否则静默降级为 file，缓存无效。

? 快速验证是否真生效

执行以下命令确认 Redis 已连通且缓存写入成功：

php think tinker
>>> (new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping()
// 返回 +PONG 表示连接正常
>>> Cache::set('test_api_cache', 'ok', 60)
>>> Cache::get('test_api_cache')
// 应返回 'ok'，若返回 null，请回头检查 ping 和配置

不复杂但容易忽略：缓存不是开了开关就自动加速，必须显式触发、显式验证。