phpEnv 的 Nginx 默认不启用 FastCGI 缓存，虽版本通常 ≥1.11.1 且含 --with-http_fastcgi_module，但主配置未定义 fastcgi_cache_path 和 keys_zone，直接使用 fastcgi_cache 会报 “unknown directive” 错误；必须手动在 http 块顶部添加缓存路径、权限及全局参数（如 fastcgi_ignore_headers），再于 location ~ \.php$ 中启用对应 keys_zone 才能生效。
phpEnv 默认不启用 FastCGI 缓存，也无内置页面静态化功能；必须手动修改 Nginx 配置并配合 PHP 逻辑才能启用。
phpEnv 的 Nginx 是否自带 fastcgi_cache 支持
phpEnv 打包的 Nginx 二进制通常不含 ngx_cache_purge 模块，且主配置中不声明 fastcgi_cache_path。即使 Nginx 版本 ≥1.11.1（原生支持 fastcgi_cache），默认也未开启缓存域 —— 所以直接写 fastcgi_cache 会报错 “unknown directive”。
验证方法：运行 nginx -V 2>&1 | grep -o with-http_fastcgi_module 确认模块存在；再执行 nginx -t 测试含 fastcgi_cache zblog; 的配置，若报错即说明未定义 keys_zone 或模块缺失。
- 若需
cache purge功能（如 WordPress 插件清缓存），必须重新编译 Nginx 并加入--add-module=../ngx_cache_purge-2.5 - 若仅需基础缓存，跳过 purge 模块，只补全
fastcgi_cache_path和对应keys_zone即可 - phpEnv 的 Nginx 配置文件路径一般为：
C:\phpEnv\config\nginx\nginx.conf（Windows）或/usr/local/phpenv/config/nginx/nginx.conf（Linux）
在 phpEnv 中启用 fastcgi_cache 的最小必要配置
不能只在 server 块里加 fastcgi_cache，必须先在 http 块顶部定义缓存路径和 zone。常见错误是把 fastcgi_cache_path 写进某个 server 块里，Nginx 启动直接失败。
立即学习“PHP免费学习笔记（深入）”；
正确做法（以 Windows phpEnv 为例）：
http {
# 必须放在所有 server 之前
fastcgi_cache_path C:/phpEnv/cache levels=1:2 keys_zone=phpenv_cache:64m inactive=30m max_size=500m;
fastcgi_temp_path C:/phpEnv/cache/temp;
<pre class='brush:php;toolbar:false;'># 全局共享的 key 规则（也可在 location 中覆盖）
fastcgi_cache_key "$scheme$request_method$host$request_uri";
# 忽略 PHP 输出的 Cache-Control/Expires，否则动态页几乎不缓存
fastcgi_ignore_headers Cache-Control Expires Set-Cookie;
server {
listen 80;
root C:/phpEnv/www;
# ... 其他配置
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# 启用缓存
fastcgi_cache phpenv_cache;
fastcgi_cache_valid 200 301 302 10m;
fastcgi_cache_valid 404 1m;
fastcgi_cache_bypass $arg_nocache; # 加 ?nocache=1 可跳过
fastcgi_no_cache $arg_nocache;
# 调试用，上线前删掉
add_header X-Cache "$upstream_cache_status";
}
}}
-
fastcgi_cache_path路径必须真实存在且 Nginx 进程有读写权限（Windows 下注意关闭杀毒软件拦截） -
keys_zone名称（如phpenv_cache）要和fastcgi_cache指令值严格一致，大小写敏感 - 避免用
/tmp或内存盘（如ramdisk:）路径，phpEnv 多数部署在 Windows，临时盘路径不稳定
PHP 页面静态化：phpEnv 下该选哪一种
phpEnv 是本地开发环境，页面静态化意义不大，但若用于演示或压测，推荐「访问时按需生成法」——它不依赖 Web 服务器重写规则，兼容 phpEnv 自带的路由逻辑，且无需额外服务（如 Cron）。
示例逻辑（放入入口文件 index.php 顶部）：
<?php
$uri = $_SERVER['REQUEST_URI'];
$static_file = __DIR__ . '/static' . $uri . '.html';
<p>// 只对 GET 请求、无 query string、非后台路径尝试静态化
if ($_SERVER['REQUEST_METHOD'] === 'GET' && empty($_GET) && strpos($uri, '/admin') !== 0) {
if (file_exists($static_file) && (time() - filemtime($static_file)) < 3600) {
readfile($static_file);
exit;
}
}</p><p>// 正常执行 PHP 逻辑...
ob_start();
include 'content.php'; // 渲染主体
$html = ob_get_clean();</p><p>// 生成静态文件（仅首页/列表页等低频更新页面才写）
if (in_array($uri, ['/', '/list.php', '/about.php'])) {
file_put_contents($static_file, $html);
}</p><p>echo $html;- 不要对用户登录态页面、表单页、搜索结果页做静态化，否则会缓存错误内容
- 生成的
.html文件需确保 Web 服务器能直接读取（phpEnv 的 Nginx 默认已支持location匹配.html） - 伪静态（如
/article/123）需额外在 Nginx 中配置try_files $uri.html $uri =404;，否则静态文件不会被命中
为什么 phpEnv 下 fastcgi_cache 容易“看似生效实则未缓存”
最常被忽略的是 Cookie 和请求头干扰。phpEnv 默认 PHP 会输出 Set-Cookie: PHPSESSID=xxx，而 Nginx 默认遇到 Set-Cookie 头就拒绝缓存 —— 即使你写了 fastcgi_ignore_headers，顺序错了也不起作用。
关键点：
-
fastcgi_ignore_headers必须放在fastcgi_cache_path之后、server块之外（即 http 块全局生效），不能只写在 location 里 - PHP 中若调用
session_start()，即使没写入数据，也会发Set-Cookie；解决方法是在不需要 session 的页面显式关闭：ini_set('session.use_cookies', 0); session_write_close(); - 浏览器开发者工具 Network 标签中检查响应头：
X-Cache: MISS表示每次都是穿透，HIT才是真缓存；BYPASS则说明fastcgi_cache_bypass条件被触发 - phpEnv 的 Windows 版本中，
fastcgi_temp_path若指向长路径或含空格路径（如C:\Program Files\...），会导致缓存完全失效，必须用短路径如C:/phpEnv/cache/temp
