静态文件缓存本质是绕过PHP直接由Web服务器返回预生成的HTML文件，关键在于Nginx在PHP执行前通过try_files和rewrite接管请求；需校验路径安全、隔离缓存目录、规范缓存键、同步删除失效文件。
静态文件缓存的本质是「绕过 PHP 执行」
动态内容生成后写入 .html 或 .php 文件，后续请求直接由 Web 服务器（如 Nginx/Apache）返回该文件，不经过 PHP 解析器。这意味着：只要缓存文件存在且未过期，index.php 根本不会被加载——性能提升来自进程层面的跳过，不是代码优化。
关键判断点：你是否真的需要“静态化”？ 如果页面仅部分变动（比如用户登录态、实时时间）、或更新频率高（秒级）、或 URL 参数多（?id=123&sort=desc），用纯静态文件缓存反而会引入失效逻辑复杂、磁盘 I/O 激增、SEO 路径爆炸等问题。
file_put_contents() 写缓存前必须做路径安全校验
常见错误是把用户可控参数（如 $_GET['id']）拼进缓存路径，导致写入任意位置：/var/www/cache/../../etc/passwd。PHP 不会自动过滤 ..，file_put_contents() 会照单全收。
- 用
basename()提取合法文件名，丢弃路径遍历字符：$cache_file = '/cache/' . basename($_GET['id']) . '.html'; - 缓存目录必须与 Web 根目录隔离（如放在
/var/tmp/myapp_cache/），禁止放在public_html下可被直接访问的路径 - 写入前检查父目录是否存在且可写：
is_writable(dirname($cache_file)) === false就中止 - 避免用
md5()或sha1()做缓存键——它们不防碰撞，且无法反查原始 URL；优先用规范化后的 URL 路径哈希（如md5(parse_url($url, PHP_URL_PATH) . '?' . http_build_query($params))）
Nginx 配置要接管静态缓存命中逻辑
光靠 PHP 写文件没用。如果请求仍走 index.php 入口，缓存就形同虚设。Nginx 必须在 PHP 执行前检查对应静态文件是否存在。
立即学习“PHP免费学习笔记（深入）”；
采用 php+mysql 数据库方式运行的强大网上商店系统，执行效率高速度快，支持多语言，模板和代码分离，轻松创建属于自己的个性化用户界面 v3.5更新： 1).进一步静态化了活动商品. 2).提供了一些重要UFT-8转换文件 3).修复了除了网银在线支付其它支付显示错误的问题. 4).修改了LOGO广告管理,增加LOGO链接后主页LOGO路径错误的问题 5).修改了公告无法发布的问题,可能是打压
典型配置片段（放在 server 块内）：
location / {
try_files $uri @php;
}
location @php {
# 检查 HTML 缓存是否存在
if (-f $document_root/cache/$uri.html) {
rewrite ^(.*)$ /cache/$1.html break;
}
fastcgi_pass php-fpm;
include fastcgi.conf;
}注意：$uri 是不含查询参数的路径，所以 /article/123 对应缓存文件是 /cache/article/123.html；带参数的 URL（如 /search?q=php）需额外处理，否则永远不命中。
缓存失效比生成更难处理
静态文件不会自己更新。一旦源数据变更（如文章被编辑），旧缓存必须立即删除或覆盖，否则用户看到脏数据。
- 不要依赖「过期时间」：用
filemtime()判断缓存是否过期，但 PHP 读文件仍是 IO，不如直接删文件 - 更新数据时同步
unlink()对应缓存文件，而不是等它过期——这是最可靠的方式 - 批量失效场景（如分类下所有文章更新），缓存路径设计要支持通配符删除（如用目录分组：
/cache/category/tech/*.html），避免全站rm -rf - 并发写入风险：多个请求同时发现缓存不存在，都去生成，造成重复写。加
flock()或用原子性file_put_contents($file, $content, LOCK_EX)
真正的难点不在怎么存，而在于「谁来删、什么时候删、删哪些」——这部分逻辑往往比业务代码还重，且容易被忽略。
