Statamic CMS 静态缓存配置优化指南

问题背景

在使用Statamic CMS构建多语言网站时，开发者经常会遇到静态缓存配置问题。特别是在多站点环境下，错误的Nginx配置会导致系统不断输出"Static cache loaded"的调试信息，严重影响网站性能。

核心问题分析

通过分析案例，我们发现主要问题出在静态缓存的路径配置和Nginx重写规则上。开发者错误地在路径中包含了域名信息，这会导致缓存系统无法正确匹配请求路径。

正确的配置方案

静态缓存路径配置

对于使用子目录作为站点URL的多语言网站（如/en、/es），正确的静态缓存路径配置应该如下：

'full' => [
    'driver' => 'file',
    'path' => [
        'es' => public_path('static') . '/',
        'en' => public_path('static') . '/',
    ],
    'lock_hold_length' => 0,
    'warm_concurrency' => 10,
],

关键点在于路径配置中不需要包含域名信息，直接使用根路径即可。

Nginx服务器配置

相应的Nginx配置也需要调整，移除$host变量：

location @static {
    try_files /static${uri}_$args.html $uri $uri/ /index.php?$args;
}

同时，建议添加以下规则来优化URL处理：

# 移除尾部斜杠
rewrite ^/(.*)/$ /$1 permanent;

# 静态缓存处理逻辑
set $try_location @static;
    
if ($request_method != GET) {
    set $try_location @not_static;            
}
    
if ($args ~* "live-preview=(.*)") {
    set $try_location @not_static;
}

location / {
    try_files $uri $try_location;
}
    
location @not_static {
    try_files $uri /index.php?$args;
}

技术原理

Statamic的静态缓存系统会为每个页面生成静态HTML文件。在多站点环境下，系统会根据请求的URL路径自动匹配对应的语言版本。当配置中包含不必要的域名信息时，会导致路径匹配失败，从而触发调试警告。

最佳实践建议

1. 对于多语言站点，优先考虑使用子目录（如/en、/es）而非子域名
2. 静态缓存路径保持简洁，避免包含冗余信息
3. 定期检查Nginx错误日志，及时发现配置问题
4. 在开发环境中启用调试模式，便于发现问题
5. 使用artisan statamic:static:warm命令预热缓存，测试配置是否正确

通过以上优化，可以确保Statamic的静态缓存系统在多语言环境下高效运行，显著提升网站性能。