需用nginx mirror模块实现thinkphp生产流量无感复制：确认版本≥1.13.4并启用模块；配置主服务与镜像后端分离；适配thinkphp入口与路由；限制镜像速率并隔离日志；验证请求全量字段一致性。
如果您在 Nginx 环境中运行 ThinkPHP 应用，并希望将生产流量无感复制至测试环境用于验证逻辑、性能或安全策略，则需借助 Nginx 内置的 ngx_http_mirror_module 模块实现镜像。该模块自 Nginx 1.13.4 起默认启用，无需额外编译，但需确保 ThinkPHP 的路由机制与镜像路径不冲突。以下是具体配置步骤：
一、确认 Nginx 版本并启用 mirror 模块
该步骤用于验证当前 Nginx 是否支持 mirror 指令，避免因模块缺失导致配置失效。Nginx 必须为 1.13.4 或更高版本，且未使用 --without-http_mirror_module 编译参数。
1、执行命令检查 Nginx 版本及模块列表：
nginx -v && nginx -V 2>&1 | grep -o 'http_mirror_module'
2、若输出为空或提示 unknown directive "mirror"，则需重新编译安装含 mirror 模块的 Nginx，或改用官方预编译包。
3、确认成功后，重启 Nginx 使模块加载生效：
sudo nginx -t && sudo systemctl reload nginx
二、配置 ThinkPHP 主服务与镜像后端分离
ThinkPHP 默认采用 PATH_INFO 或兼容模式解析 URL，镜像请求必须复现原始请求路径与参数，因此需确保主 location 与 mirror location 共享相同 URI 结构，且镜像后端能正确识别 ThinkPHP 的入口逻辑（如 index.php 或伪静态规则）。
1、定义 upstream 块，分别指向 ThinkPHP 主应用与镜像目标：
upstream tp_primary { server 127.0.0.1:8000; }
upstream tp_mirror { server 127.0.0.1:8001; }
2、在 server 块中配置主 location，启用 mirror 并保留请求体：
location / {
mirror /mirror;
mirror_request_body on;
proxy_pass http://tp_primary;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
3、添加 internal 镜像处理 location，强制转发至镜像后端并剥离敏感头信息：
location = /mirror {
internal;
proxy_pass http://tp_mirror$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Authorization "";
proxy_set_header Cookie "";
proxy_connect_timeout 2s;
proxy_send_timeout 5s;
proxy_read_timeout 5s;
}
三、适配 ThinkPHP 入口与路由行为
ThinkPHP 在 Nginx 下常通过 rewrite 规则隐藏 index.php，镜像请求若未携带完整 PATH_INFO 或 QUERY_STRING，可能导致路由解析失败。因此需确保镜像请求中所有原始变量均被透传，且镜像后端 ThinkPHP 实例配置与主站一致。
1、在主 location 中显式传递 PATH_INFO 与 SCRIPT_NAME：
proxy_set_header PATH_INFO $fastcgi_path_info;
proxy_set_header SCRIPT_NAME /index.php;
2、镜像后端 ThinkPHP 的 .env 文件中，确保 APP_DEBUG=false 且 APP_ENV=mirror，避免日志污染主环境；同时禁用数据库写操作（如重写 Db 类或注入只读中间件）。
3、若使用 ThinkPHP 6+ 的多应用模式，镜像后端应部署独立应用目录，并在入口文件中加载对应应用配置，防止 session 或缓存键冲突。
四、限制镜像速率并隔离访问日志
高频镜像可能对测试环境造成压力，且镜像请求不应混入主站访问日志，需单独记录以便审计与问题回溯。
1、在主 location 中添加限速指令，防止突发流量压垮镜像后端：
mirror_rate_limit 500r/s;
2、为镜像请求配置专属 access_log，格式中加入标识字段便于区分：
log_format mirror_fmt '$time_iso8601 [MIRROR] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"';
access_log /var/log/nginx/tp_mirror_access.log mirror_fmt;
3、在 server 块顶层添加日志指令，确保仅镜像 location 生效：
location = /mirror {
access_log /var/log/nginx/tp_mirror_access.log mirror_fmt;
# 其余 proxy 配置同上
}
五、验证镜像请求是否完整到达 ThinkPHP 镜像实例
镜像有效性依赖于请求头、URI、请求体、查询参数等全量数据的准确复制。需在镜像后端 ThinkPHP 中添加临时调试逻辑，捕获并记录原始镜像请求特征，以确认无关键字段丢失。
1、在镜像后端的全局中间件中插入日志记录：
Log::write('MIRROR-REQ: ' . json_encode([
'uri' => request()->url(),
'method' => request()->method(),
'params' => request()->param(),
'header' => request()->header(),
'rawBody' => file_get_contents('php://input')
]), 'mirror');
2、向主站发起含 POST body 与 query 参数的请求：
curl -X POST "http://your-domain.com/index/user/login?from=web" -d '{"username":"test","password":"123"}' -H "Content-Type: application/json"
3、检查镜像后端日志文件，确认 uri、method、params、header、rawBody 字段与主请求完全一致，且无 Authorization 或 Cookie 头泄露。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
