ThinkPHP代理系统开发教程-ThinkPHP-PHP中文网

thinkphp本身不提供代理功能，所谓“代理”实为nginx层配置proxy_pass或fastcgi_pass；直接用php写代理存在ssrf、超时、内存溢出及协议兼容等严重风险，应优先交由nginx处理。

thinkphp代理系统开发教程

ThinkPHP 本身不是代理系统，也不内置 HTTP 代理功能；所谓“ThinkPHP 代理系统”，实际是用 ThinkPHP 搭建一个前端请求转发服务（即 PHP 写的反向代理网关），或更常见的是——在 Nginx 层面为 ThinkPHP 应用配置 proxy_pass 或 fastcgi_pass，让它能被正确代理访问。直接用 ThinkPHP 的 PHP 代码实现完整代理（如中转任意第三方 URL）不仅性能差、易超时、难维护，还存在严重安全风险。

用 ThinkPHP 写 PHP 代理脚本？不推荐

有人试图在 ThinkPHP 的控制器里用 curl_exec() 或 file_get_contents() 转发请求，比如：

public function proxy()
{
    $url = input('url');
    echo file_get_contents($url); // 危险！无校验、无超时、无 header 过滤
}

这种写法问题极多：

input('url') 若未白名单校验，攻击者可传入 file:///etc/passwd 或内网地址，造成 SSRF 漏洞
目标响应头（如 Set-Cookie、Content-Disposition）不会自动透传，前端行为异常
大文件下载会内存溢出，file_get_contents 不支持流式转发
无法处理重定向、分块传输、WebSocket 等协议特性

除非你明确需要做「带业务逻辑的轻量级中间层」（例如统一加签、日志审计、灰度路由），否则别用 PHP 写代理——交给 Nginx 做更稳、更快、更安全。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

Nginx 配置 proxy_pass 到 Swoole 服务

这是 ThinkPHP 高性能部署最常用的方式：ThinkPHP 启动 Swoole HTTP Server（监听 127.0.0.1:9501），Nginx 仅作反向代理入口。关键点在于路径透传和 WebSocket 支持：

必须在 location / 块末尾加 /，即 proxy_pass http://127.0.0.1:9501/;（少斜杠会导致路径错位）
ThinkPHP 的 URL 生成依赖 $_SERVER['REQUEST_URI']，需确保 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 和 X-Real-IP 正确设置，否则 Request::ip() 取不到真实 IP
若项目含 WebSocket 接口（如聊天、通知），必须启用 Upgrade 和 Connection 头，否则握手失败
Swoole 启动时需显式设置 enable_static_handler => false，静态资源仍由 Nginx 托管

fastcgi_pass 直连 PHP-FPM 时的 PATH_INFO 兼容问题

ThinkPHP 默认使用 PATH_INFO 模式（如 /index.php/user/list），但 Nginx 的 fastcgi_pass 默认不解析 PATH_INFO，导致路由 404。解决方法不是改框架，而是补全 Nginx 配置：

确认 fastcgi_split_path_info 已启用，并正则匹配到 .php 后路径：fastcgi_split_path_info ^(.+\.php)(/.+)$;
必须设置 fastcgi_param PATH_INFO $fastcgi_path_info;，否则 ThinkPHP 的 Route 类收不到子路径
不要用 try_files $uri $uri/ /index.php?$query_string; 这种 Laravel 风格写法——ThinkPHP 的入口是 index.php，不是靠 query string 驱动路由
若用宝塔面板，勾选「ThinkPHP 伪静态」规则后，仍需手动检查生成的配置是否包含 PATH_INFO 传递

代理场景下 ThinkPHP 的 Request 对象行为变化

当请求经 Nginx 代理后，Request 类读取的原始数据来源变了，几个关键字段容易误判：

Request::root() 返回 http://domain.com，但实际应以 X-Forwarded-Proto 和 Host 头为准，否则 HTTPS 站点生成的 URL 是 http://
Request::domain() 默认读 $_SERVER['HTTP_HOST']，若 Nginx 未透传 Host 头，会返回 127.0.0.1 这类错误值
Request::url() 在 PATH_INFO 模式下依赖 REQUEST_URI，而该值在 proxy_pass 场景下由 Nginx 注入，fastcgi_pass 场景下由 FPM 注入，二者行为不一致
解决方案：在 app/common.php 中统一覆盖 $_SERVER 变量，例如：if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) { $_SERVER['HTTPS'] = $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https' ? 'on' : 'off'; }