一、现象
站点用 Nginx / OpenResty 反代 PHP(1Panel 容器、宝塔都一样),访问带主题预览参数的地址:
https://example.com/?theme=lcbk-stationery
浏览器直接吐 502 Bad Gateway。但去掉 ?theme= 访问首页一切正常,PHP 错误日志、emlog 日志里干干净净,容器也没重启记录。第一反应往往是「PHP 崩了」或者「伪静态出问题了」,方向全错。
二、先看响应头,别急着翻日志
502 是网关吐的,不是 PHP 吐的。用 curl 把响应头拉出来数一下:
curl -sL -D - -o /dev/null "https://example.com/?theme=lcbk-stationery" | grep -ci 'set-cookie: *emlog_theme'
出问题的站上,这个数字是几十到几百。也就是说 PHP 正常执行完了,但它在一次响应里塞了几百行一模一样的:
Set-Cookie: emlog_theme=lcbk-stationery; expires=...; Max-Age=86400; path=/
Nginx 反代读上游响应头是有缓冲上限的(proxy_buffer_size),头部总量超了就直接判定上游异常,回 502,错误日志里通常只留一句 upstream sent too big header。PHP 侧毫无异常,所以日志干净 —— 这就是为什么这个故障看起来跟 PHP 无关。
注意
-L不能省。如果域名有 301(比如裸域跳 www),不加-L只会拿到跳转响应,grep 结果是0,你会误判成「没问题」。先确认探针拿到了 200,再谈数量。
三、根因:setcookie() 不会更新 $_COOKIE
问题出在核心文件 include/service/template.php 的 getCurrentTemplate():
$themeCookieName = 'emlog_theme';
$theme = Input::getStrVar('theme');
if ($theme && preg_match('/^[\w\-]+$/', $theme)) {
setcookie($themeCookieName, $theme, time() + 86400, '/');
return $theme;
}
三个事实凑在一起就炸了:
setcookie()只是往响应头里追加一行,它不修改当前请求的$_COOKIE。$_COOKIE是请求进来时解析好的快照,本次请求内不会变。- 这个函数在一次渲染里被调用非常多次。
init.php里定义TEMPLATE_URL、TEMPLATE_PATH各调一次;装了模板设置插件后,主题里每一个_g('xxx')都会走TplOptions::getTemplateOptions()→Template::getCurrentTemplate()。一个首页取上百个设置项,就是上百次调用。 - 只要 URL 上挂着
?theme=,每一次调用都命中上面那个if,于是每次都新发一行 Set-Cookie。
不带 ?theme= 时走的是 cookie 分支,不发头,所以首页正常 —— 故障只在预览链接上出现,也是它容易被误判的原因。
四、修改方法
编辑 include/service/template.php,把上面那段 if 换成:
if ($theme && preg_match('/^[\w\-]+$/', $theme)) {
if (!isset($_COOKIE[$themeCookieName]) || $_COOKIE[$themeCookieName] !== $theme) {
setcookie($themeCookieName, $theme, time() + 86400, '/');
$_COOKIE[$themeCookieName] = $theme;
}
return $theme;
}
$_COOKIE[$themeCookieName] = $theme; 这行写回是整个补丁的关键,绝对不能省。 只加外层判断不写回,$_COOKIE 在本次请求里永远是空/旧值,判断永远成立,几百行 Set-Cookie 一行不少 —— 改了等于没改,还会让你以为「补丁无效」而往别的方向排查。
加上写回后,本次请求内第一次调用发一个 Cookie,后续调用全部命中 === $theme 直接跳过。
让它真正生效
- 改之前先备份:
cp template.php template.php.bak。 - 改完重启 PHP 容器 / PHP-FPM。OPcache 会缓存旧字节码,不重启的话文件改了、行为不变,看起来就像补丁没起作用。
- 再跑一次第二步那条 curl,数量应该降到 0~2(
init.php调两次,个别版本会留下 2 行,属正常),页面返回 200。
五、不想改核心文件?关掉主题切换
?theme= 预览是由 config.php 里的开关控制的:
if (!defined('SWITCH_TEMPLATE')) define('SWITCH_TEMPLATE', true);
把 true 改成 false,getCurrentTemplate() 会直接返回后台设置的主题,压根不走 setcookie 分支,502 立刻消失。代价是失去前台主题预览能力。如果你只是自己开发时用预览,可以本地开着、线上关掉;如果线上必须保留预览,就用第四节的核心补丁。
六、每次 emlog 升级后都要复查
这是改核心文件的通病:升级会覆盖 include/service/template.php,补丁被静默冲掉,502 原地复活,而且往往在你升级完几天后点预览链接才发现。
把这条一行巡检记下来,升级后顺手跑一次:
curl -sL -D - -o /dev/null "https://example.com/?theme=你的主题目录名" | grep -ci 'set-cookie: *emlog_theme'
0~2 = 补丁还在;几十上百 = 已被覆盖,重新打一遍并重启 PHP。
另外,事故期间在 OpenResty 里调大的 proxy_buffer_size 建议留着当保险 —— 它不解决重复头的问题,但能抬高网关的容忍阈值,避免别的插件重复发头时再次 502。
七、小结
| 环节 | 要点 |
|---|---|
| 定位 | 502 先看响应头数量,不要先翻 PHP 日志 |
| 根因 | setcookie() 不写回 $_COOKIE + 函数被高频调用 |
| 修复 | 加去重判断,并写回 $_COOKIE |
| 生效 | 重启 PHP / 容器,清掉 OPcache 旧字节码 |
| 长期 | 升级会覆盖核心,升级后跑一行 curl 复查 |