需通过 Nginx 的 ngx_http_memcached_module 模块实现键值代理式缓存读取，确保 ThinkPHP 6 与 Nginx 使用一致 key 格式、纯文本响应体，并配置 memcached_pass + error_page 回退至 PHP-FPM；Windows 用户可改用 proxy_cache 替代。
如果您在使用 ThinkPHP 6 构建的 Web 应用中已启用 Memcached 缓存，但希望 Nginx 层面能直接读取该缓存以跳过后端 PHP 处理、降低响应延迟，则需通过 Nginx 的 ngx_http_memcached_module 模块实现键值代理式缓存读取。以下是实现此目标的具体配置路径与操作步骤：
一、确认 Nginx 已启用 memcached 模块
该模块是 Nginx 原生支持的 HTTP 模块之一，但并非所有预编译版本都默认开启。其作用是让 Nginx 能够直连 Memcached 实例并根据请求生成 key 进行查询。
1、执行命令验证模块是否存在：nginx -V 2>&1 | grep -o with-http_memcached_module
2、若无输出，说明当前 Nginx 不含该模块；Ubuntu/Debian 用户可安装 nginx-full 包替代 nginx-light
立即学习“PHP免费学习笔记（深入）”；
3、Windows 用户须注意：官方 Windows 版 Nginx 不包含此模块，应改用 WSL2 + OpenResty 或切换至 proxy_cache 方案
二、统一缓存键（key）生成规则
ThinkPHP 6 写入 Memcached 的 key 格式必须与 Nginx 中定义的 $memcached_key 完全一致，否则无法命中。默认情况下 ThinkPHP 使用前缀 + md5(URI) 或自定义字符串，需主动对齐。
1、查看 ThinkPHP 配置文件 config/cache.php 中 memcached store 的 key 前缀与哈希逻辑
2、在 Nginx location 块中设置匹配的 key 变量，例如：set $memcached_key "tp6:$scheme$host$request_uri";
3、若 ThinkPHP 使用了序列化或压缩存储，Nginx 无法解析其二进制内容，必须确保写入 Memcached 的 value 是纯文本或合法 HTTP 响应体（不含头信息）
三、配置 Nginx location 代理 Memcached 读取
此步骤定义 Nginx 如何将特定请求路由至 Memcached 查询，并在未命中时交由 ThinkPHP 后端处理，形成“缓存穿透兜底”机制。
1、在 server 块内添加专用 location，如匹配 /api/ 或 /index.php 路径：location ~ ^/(api|index\.php) {
2、设置 key 并启用 memcached_pass：set $memcached_key "tp6:$scheme$host$request_uri"; memcached_pass 127.0.0.1:11211;
3、配置错误页回退逻辑：error_page 404 502 504 = @thinkphp;
4、定义 @thinkphp 处理块，透传至 PHP-FPM：location @thinkphp { include fastcgi_params; fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root/index.php; }
四、确保 ThinkPHP 主动写入缓存响应
Nginx 的 memcached_pass 指令仅执行读操作，所有缓存写入必须由 ThinkPHP 应用在业务逻辑中完成，且需覆盖完整 HTTP 响应体（不含状态行与头）。
1、在控制器中获取渲染后的内容：$content = response()->getContent();
2、使用 Cache::store('memcached') 写入，key 与 Nginx 中一致：Cache::store('memcached')->put("tp6:https:example.com/api/user", $content, 300);
3、避免写入非法格式：严禁将 HTTP/1.1 200 OK 或 Content-Type: application/json 等头部信息存入 Memcached
4、建议在中间件中统一拦截 GET 请求并自动缓存成功响应，同时设置合理 TTL（如 30–300 秒）
五、Windows 环境下的替代方案配置
当运行环境为 Windows 且无法启用 memcached 模块时，可采用 Nginx 自带 proxy_cache 机制模拟相同效果，无需额外服务依赖，且完全兼容。
1、在 http 块中声明缓存区：proxy_cache_path C:/nginx/cache levels=1:2 keys_zone=tp6cache:10m max_size=500m inactive=10m use_temp_path=off;
2、在 location 中启用缓存：proxy_cache tp6cache; proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m;
3、透传关键变量以区分请求：proxy_cache_key "$scheme$host$request_uri"; proxy_set_header Host $host;
4、添加响应头标识缓存状态便于调试：add_header X-Proxy-Cache $upstream_cache_status;
