phpEnv默认不支持负载均衡,Session保持需Nginx显式配置或后端配合;ip_hash虽简单但受NAT、网络切换和节点宕机影响;推荐proxy_cookie_path路由或统一存Redis(需启用redis扩展并启动phpEnv Redis服务)。

phpEnv 本身不提供负载均衡能力,Session 保持必须由 Nginx 层显式配置或后端配合实现;直接用 phpEnv 的默认 Nginx 配置跑多 PHP-FPM 实例,默认会丢失登录态。
ip_hash 是最简单但有明显缺陷的方案
在 upstream 块中启用 ip_hash,可让同一客户端 IP 始终打到同一台 PHP-FPM 实例:
upstream php_backend {
ip_hash;
server 127.0.0.1:9001;
server 127.0.0.1:9002;
}但它的问题很实际:
- 企业/校园出口 NAT 后所有用户共用一个公网 IP,
ip_hash会让全部请求挤在一台后端上,彻底失去负载意义 - 用户切换网络(比如从 WiFi 切 4G),IP 变了,Session 就断了,得重新登录
- 后端宕机时,Nginx 会把该 IP 的流量强制切到其他节点,但旧 Session 数据不在那里,依然失效
proxy_cookie_path + Set-Cookie 路由是更可控的选择
如果你能控制 PHP 应用返回的响应头(比如 Laravel、ThinkPHP 等框架),推荐用 Cookie 标识后端节点:
立即学习“PHP免费学习笔记(深入)”;
location ~ \.php$ {
proxy_pass http://php_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
# 关键:把后端地址写进 Set-Cookie,路径限定为根,且禁用 JS 访问
proxy_cookie_path / "/; HttpOnly; Secure";
proxy_set_header Set-Cookie "ROUTE=$upstream_addr; Path=/; HttpOnly; Secure";
}注意两点:
-
$upstream_addr是 Nginx 内置变量,值形如127.0.0.1:9001,需确保后端 PHP-FPM 监听的是明确 IP+端口(不能只写localhost:9001,否则变量为空) - PHP 应用本身不能覆盖这个
Set-Cookie,否则路由失效;建议在框架中间件里检查$_COOKIE['ROUTE']并提前 exit 或跳过 session 初始化
session 存 Redis 才是真正解耦 Session 和节点绑定的方案
phpEnv 默认用文件存 session(session.save_handler = files),这在多实例下天然不共享。改成 Redis 后,所有 PHP-FPM 实例读写同一个地方:
修改 php.ini(注意:phpEnv 中每个 PHP 版本有独立 php.ini,别改错):
session.save_handler = redis session.save_path = "127.0.0.1:6379" session.cookie_httponly = 1 session.cookie_secure = 1
无需改 Nginx 配置,也不依赖客户端 IP 或 Cookie 路由。但要注意:
- phpEnv 自带的 Redis 服务默认未开启,需手动启动:
phpenv redis start - 如果用了 Redis 密码,
session.save_path要写成"redis://:yourpass@127.0.0.1:6379" - PHP 扩展
redis或phpredis必须已启用(phpEnv 安装时通常已包含)
别忽略 phpEnv 的 upstream 与 fastcgi_pass 混用风险
很多人在 phpEnv 里误用 fastcgi_pass 直连 PHP-FPM,却还在 upstream 里配了 ip_hash —— 这完全无效,因为 fastcgi_pass 不走 upstream 调度逻辑。
正确做法只有两种:
- 用
proxy_pass http://php_backend(此时必须后端是 HTTP 服务,比如用 php-fpm + nginx 或 Swoole HTTP Server) - 用
fastcgi_pass php_backend(此时upstream名必须和fastcgi_pass后名称一致,且upstream内必须用server unix:/path/to/php.sock或server 127.0.0.1:9001,ip_hash在 fastcgi 场景下是支持的)
多数 phpEnv 用户卡在这一步:看到文档写 upstream 就以为自动生效,结果 Nginx 根本没转发过去。



















