需启用Nginx SSI模块并配置ssi on、ssi_types text/html、正确处理ThinkPHP输出的HTML中未转义SSI指令，且确保PHP响应经SSI过滤器处理。
如果您在ThinkPHP项目中希望利用Nginx的SSI（Server Side Includes）功能动态嵌入公共片段（如页头、页脚或用户状态栏），但页面中SSI指令未被解析，则可能是Nginx未启用SSI模块或未正确匹配响应MIME类型。以下是实现Nginx服务端包含ThinkPHP片段的具体配置步骤：
一、确认Nginx已编译并启用SSI模块
ngx_http_ssi_filter_module是Nginx的内置过滤模块，但需在编译时显式启用（--with-http_ssi_module）。若使用官方预编译包或主流Linux发行版仓库安装的Nginx，该模块通常已存在；若自行编译且遗漏此选项，则SSI指令将完全不生效。
1、执行命令检查模块是否加载：nginx -V 2>&1 | grep -o with-http_ssi_module
2、若无输出，需重新编译Nginx并添加--with-http_ssi_module参数
立即学习“PHP免费学习笔记（深入）”；
3、若输出with-http_ssi_module，说明模块可用，可继续配置
二、在location块中启用SSI并指定处理类型
SSI指令仅对满足MIME类型匹配且响应内容经由SSI过滤器处理的请求生效。ThinkPHP默认返回text/html，因此必须显式设置ssi_types包含text/html，否则即使ssi on也无效。
1、在ThinkPHP对应的server或location配置段内添加：ssi on;
2、添加：ssi_silent_errors on;（避免错误时暴露原始SSI指令）
3、添加：ssi_types text/html;（关键：必须显式声明支持text/html，因ThinkPHP不使用.shtml后缀）
4、确保响应头Content-Type确为text/html（可通过curl -I验证）
三、配置ThinkPHP响应支持SSI解析
ThinkPHP本身不干预HTTP响应体内容，但需确保其输出的HTML中SSI指令格式合法且未被转义。常见问题包括模板引擎自动HTML转义导致<!--#include ...-->被渲染为纯文本。
1、在ThinkPHP模板中直接写入未转义的SSI注释：<!--#include virtual="/public/inc/header.html"-->
2、若使用{literal}标签（如Smarty风格）或关闭当前区块自动转义（如ThinkPHP的{:}或{~}语法），防止<!--被编码为<!--
3、确认被包含文件（如/public/inc/header.html）存在于Nginx root路径下，且Nginx有读取权限
4、被包含文件内容不得包含非法SSI语法，例如禁止嵌套<!--#include-->或缺失闭合符号
四、调整静态资源与PHP处理逻辑避免冲突
当Nginx同时处理PHP脚本和SSI指令时，需确保SSI在PHP响应生成后、发送前被处理。若location匹配顺序不当，可能导致PHP响应绕过SSI过滤器。
1、将SSI配置置于处理PHP的location之前，例如放在location / { ... }主块中
2、避免在location ~ \.php$内部启用SSI，因其仅作用于.php文件自身，而非PHP输出的HTML
3、推荐结构：主location启用SSI，并用try_files $uri @php分发请求；PHP处理完成后返回的text/html响应将进入SSI过滤流程
4、验证响应是否经过SSI：在被包含文件中写入唯一标识字符串（如[SSI-LOADED]），访问页面源码确认该字符串存在
五、调试SSI失效的常见路径
当页面显示原始SSI注释而非嵌入内容时，需按顺序排查底层拦截点。每个环节失败都会导致SSI静默跳过。
1、检查Nginx错误日志：tail -f /var/log/nginx/error.log，查找含“ssi”或“directive”的警告
2、确认请求响应头中X-Accel-Buffering未设为no（禁用缓冲会干扰SSI）
3、临时关闭所有gzip压缩：gzip off;，因压缩流可能使SSI无法定位注释位置
4、在location中添加add_header X-SSI-Status "enabled";，通过响应头确认该块确实启用了SSI
