Nginx接入ThinkPHP的SCGI配置需解决协议兼容、PATH_INFO解析及路径映射问题，推荐使用Unix域套接字方案并手动精简scgi_param参数集。
如果您在Nginx中尝试将ThinkPHP应用以SCGI协议方式接入，但请求无法正确转发或后端无响应，则可能是由于SCGI协议配置缺失、参数传递错误或路径解析异常所致。以下是多种可行的配置方案：
一、基于scgi_pass的纯SCGI直连配置
该方式绕过FastCGI兼容层，直接使用SCGI协议与ThinkPHP的SCGI服务通信，适用于已部署独立SCGI服务器（如通过Flup、uWSGI SCGI模式或自研SCGI守护进程）的场景。需确保ThinkPHP应用已启动SCGI监听服务并绑定到指定地址。
1、确认ThinkPHP应用已启用SCGI服务，例如监听127.0.0.1:4000或Unix套接字/run/thinkphp.scgi.sock；
2、在Nginx的http块中定义缓存区（可选，但推荐启用）：proxy_cache_path /var/cache/nginx/thinkphp_scgi levels=1:2 keys_zone=thinkphp_scgi:10m max_size=512m inactive=30m use_temp_path=off;；
立即学习“PHP免费学习笔记（深入）”；
3、在server块内添加location匹配规则，例如匹配根路径或/index.php入口：
4、在该location中配置SCGI转发参数，必须显式设置scgi_param SCGI 1，并禁用默认CGI头注入；
5、手动定义关键参数，避免引入include scgi_params（因其含大量ThinkPHP非必需变量，易引发PATH_INFO解析冲突）：
6、设置超时与缓冲以适配ThinkPHP响应特性：
scgi_read_timeout 90;<br>scgi_send_timeout 90;<br>scgi_buffering on;<br>scgi_buffers 8 32k;<br>scgi_busy_buffers_size 64k;；
7、验证Nginx配置语法并重载：nginx -t && nginx -s reload。
二、兼容ThinkPHP URL重写逻辑的SCGI+PATH_INFO修正配置
ThinkPHP默认依赖PATH_INFO实现路由解析，而标准SCGI参数中$fastcgi_path_info在非FastCGI上下文中不可靠。本方案通过Nginx重写与手动构造PATH_INFO，确保ThinkPHP能正确识别路由路径。
1、在location块中先进行URI重写，将/admin/user/list类路径统一映射至/index.php/admin/user/list：
2、使用if (!-e $request_filename)判断静态资源不存在后触发重写，注意此指令仅允许在location内使用；
3、在重写后的location中配置scgi_pass，并显式构造PATH_INFO：
4、设置scgi_param PATH_INFO $path_info;，其中$path_info由正则捕获变量赋值；
5、同步设置scgi_param SCRIPT_FILENAME $document_root/index.php;，强制指定入口文件；
6、补充scgi_param REQUEST_URI $request_uri;和scgi_param QUERY_STRING $query_string;以保障URL参数完整传递；
7、确保root指令指向ThinkPHP的public目录（如/var/www/thinkphp/public），而非项目根目录。
三、Unix域套接字安全型SCGI配置（推荐生产环境）
使用Unix域套接字替代TCP端口可避免网络栈开销及端口暴露风险，同时提升IPC效率。该方案要求ThinkPHP SCGI服务以socket文件形式运行，并严格控制文件权限与SELinux上下文（如适用）。
1、确认SCGI服务以www-data或nginx用户身份运行，并监听/var/run/thinkphp.sock；
2、创建socket目录并授权：mkdir -p /var/run/thinkphp; chown nginx:nginx /var/run/thinkphp; chmod 755 /var/run/thinkphp;；
3、在location中配置scgi_pass unix:/var/run/thinkphp.sock;；
4、必须设置scgi_param SCGI 1，否则SCGI握手失败；
5、禁用所有自动注入的CGI变量，仅保留以下最小集：
6、添加权限校验指令：scgi_next_upstream error timeout http_500 http_502 http_503 http_504;；
7、检查Nginx worker进程对socket文件的读写权限，若出现Permission denied，需确认user指令与socket属主一致，并在systemd服务中设置SupplementaryGroups=www-data（如适用）。
四、调试与错误日志定位配置
当SCGI请求返回502 Bad Gateway或空白响应时，需启用细粒度日志以定位协议层或参数层问题。本方案不修改业务逻辑，仅增强可观测性。
1、在对应server块中增加error_log /var/log/nginx/thinkphp_scgi_error.log debug;（仅临时启用，避免磁盘爆满）；
2、在location中添加scgi_param HTTP_X_REAL_IP $remote_addr;用于透传真实IP；
3、启用SCGI请求体记录（谨慎使用）：scgi_buffering off;配合scgi_max_temp_file_size 0;，强制Nginx不缓存请求体，便于抓包分析原始SCGI帧；
4、使用tcpdump -i lo -w scgi.pcap port 4000捕获本地SCGI流量，用Wireshark打开查看SCGI头部是否含SCGI\x00标识及CONTENT_LENGTH\0...结构；
5、检查ThinkPHP侧日志是否收到SCRIPT_FILENAME为/var/www/thinkphp/public/index.php且PATH_INFO为预期值（如/admin）；
6、若Nginx错误日志出现no live upstreams，说明scgi_pass指向的服务未启动或监听地址不可达；
7、若出现upstream sent too big header，需调大scgi_buffer_size至64k以上。
