2024WordPress前端优化之Nginx fastcgi_cache缓存

WordPress优化加速老白博客之前分享过很多了，都是非常小白的教程，包括很多openlitespeed环境和宝塔面板NGINX环境的。今天分享的是基于宝塔面板的“配置 Nginx fastcgi_cache缓存”，适用于WordPress前端优化，后端建议大家使用memcached/redis来优化数据库即可，教程见：https://www.xcbtmw.com/29717.html。

2024WordPress前端页面优化之配置 Nginx fastcgi_cache缓存

使用memcached或者redis做好数据库缓存及优化后，接下来可以使用 Nginx fastcgi_cache进行前端页面的缓存优化。

WordPress缓存详解：https://www.xcbtmw.com/29813.html

1.宝塔面板安装ngx_cache_purge

宝塔默认已经安装ngx_cache_purge模块，大家可以使用下面的命令行查看，当然也可以用 Nginx -V 来查看的所有编译模块里面有没有这个模块

    # nginx -V 2>&1 | grep -o ngx_cache_purge 查看ngx_cache_purge是否安装,没有数据表示未安装

因此只需要通过修改配置文件来启用此模块。选择对应网站，点击设置，修改配置文件！

注意

这里的配置文件，是对应网站的配置文件，不是nginx软件模块的配置文件

2.ngx_cache_purge模块配置

2.1 准备工作

2.1.1 设置缓存路径

文件缓存还是内存缓存？

在fastcgi_cache_path中，可以将它设置为内存路径，例如：/dev/shm/nginx-cache levels=1:2 keys_zone=WORDPRESS:100m inactive=60m;，如果你的磁盘IO很慢的话建议采用此方式，毕竟内存的读写速度非常快。
当然，你也可以使用文件缓存路径：/tmp/nginx-cache

选择好了以后，需要在对应的目录（/dev/shm或者/tmp）下创建对应的文件夹nginx-cache

说明

下文的教程默认选择使用内存缓存

2.1.2 缓存密钥

就是keys_zone=WORDPRESS中的WORDPRESS，你可以设置为自己喜欢的，但注意配置中需保持一致，每一个网站设置一个专用的

2.2 服务器配置Nginx fastcgi_cache

2.2.1 选择设置站点

首先，将以下代码复制到网站配置文件顶部

fastcgi_cache_key "$scheme$request_method$host$request_uri";
fastcgi_cache_path /dev/shm/nginx-cache levels=1:2 keys_zone=WORDPRESS:100m inactive=60m;
fastcgi_cache_use_stale error timeout invalid_header http_500;
fastcgi_ignore_headers Cache-Control Expires Set-Cookie;

2.2.2 缓存设置

然后在server字段下添加以下代码，老白建议添加在 #SSL-END下方：

set $skip_cache 0;
        #post访问不缓存
        if ($request_method = POST) {
            set $skip_cache 1;
        }   
        #动态查询不缓存
        if ($query_string != "") {
            set $skip_cache 1;
        }  
        #后台等特定页面不缓存（其他需求请自行添加即可）
        if ($request_uri ~* "/wp-admin/|/xmlrpc.php|wp-.*.php|/feed/|index.php|sitemap(_index)?.xml") {
            set $skip_cache 1;
        }   
        #对登录用户、评论过的用户不展示缓存
      if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_no_cache|wordpress_logged_in") {
            set $skip_cache 1;
        }
       #如果需要对所有用户缓存，请将以上代码改为下方的，两段代码只可任选其一
        #if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+") {
            #set $skip_cache 1;
        #}
        #这里请参考你网站之前的配置，特别是sock的路径，弄错了就502了！
        location ~ [^/].php(/|$)
            {
                try_files $uri =404;
                fastcgi_pass unix:/tmp/php-cgi-82.sock;
                fastcgi_index index.php;
                include fastcgi.conf;  
                add_header Strict-Transport-Security "max-age=63072000; includeSubdomains; preload";
                #新增的缓存规则
                fastcgi_cache_bypass $skip_cache;
                fastcgi_no_cache $skip_cache;
                add_header X-Cache "$upstream_cache_status From $host";
                fastcgi_cache WORDPRESS;
                add_header Cache-Control  max-age=86400;
                add_header Nginx-Cache "$upstream_cache_status";
                add_header Last-Modified $date_gmt;
                add_header X-Frame-Options SAMEORIGIN; # 只允许本站用 frame 来嵌套
                add_header X-Content-Type-Options nosniff; # 禁止嗅探文件类型
                add_header X-XSS-Protection "1; mode=block"; # XSS 保护
                etag  on;
                fastcgi_cache_valid 200 12h;
                fastcgi_cache_valid 301 302 3d;
                fastcgi_cache_valid 304 1d;
        }
 
        #缓存清理配置（可选模块，请细看下文说明）
        location ~ /purge(/.*) {
            allow 127.0.0.1;
            allow （老白）你（博）的（客）服务（提示）器IP;
            deny all;
            fastcgi_cache_purge WORDPRESS "$scheme$request_method$host$1";
        }

2.2.3 配置注意事项

1）add_header Cache-Control如果是动态内容要实时更新的话，可以设置为0，否则可以设置时间大一些，单位是秒。

2）sock的路径一定要填对，否则会出现502错误，关于sock，直接去/tmp/目录下查看对应的文件即可，类似老白博客的php-cgi-82.sock;

3）代码里面的服务器公网IP换成你的服务器公网IP。

4）可选缓存配置：某些主题如果移动端访问报错，可以设置不缓存移动端

    #不缓存移动端访问
    if ($http_user_agent ~* (mobile|nokia|iphone|ipad|android|samsung|htc|blackberry|windowss(ce|phone))) {
            set $skip_cache 1;
    }

5）如果出现评论过的用户依然用的是缓存，那应该是wordpress没有记住cookie，把以下代码加入到functions.php 中即可。

//nginx-cache缓存配置代码-老白博客https://www.xcbtmw.com/29981.html
add_action('set_comment_cookies','coffin_set_cookies',10,3);
function coffin_set_cookies( $comment, $user, $cookies_consent){
   $cookies_consent = true;
   wp_set_comment_cookies($comment, $user, $cookies_consent);
}

6）启用fastcgi_cache缓存时，发现在Nginx配置文件中添加了Cache-Control信息，但是总是不生效。HTTP头部信息会总会包含以下信息：

Cache-Control: no-store,no-cache,must-revalidate,post-check=0,pre-check=0 和 Pragma: no-cache

修改宝塔面板中php配置文件中的关键词session.cache_limiter，默认值是 nocache ，将它设置为none即可

session.cache_limiter=none

3.WordPress缓存处理配置

3.1 Nginx Helper插件法

进入WordPress 后台插件安装界面搜索 Nginx Helper 关键词在线安装即可

（插件默认是英文的，如果要设置中文看这个：https://www.xcbtmw.com/29439.html）

1）开启purge，选择nginx Fastcgin cahe，因为就我们用就是这个缓存。

2）选择 Delete local server cache files。当然第一个也可以用，但是一般推荐用Delete local server cache files，因为每个服务器的环境都不一样，缓存路径也会不尽相同就会导致插件无法找到缓存文件并删除！

3）插件下面还提供了其它的一些设置，功能非常丰富，例如发表新文章、新评论时是否更新Nginx缓存等，根据自己需要勾选即可。

3.1.1 插件法注意事项

由于插件作者定义的缓存路径是 /var/run/nginx-cache ，而我们可能会根据服务器实际情况来自定义缓存路径，这样一来，缓存路径的不同就会导致插件无法找到缓存文件并删除。

添加以下代码到WordPress根目录的wp-config.php文件中。

 //老白提示-根据实际情况定义缓存的存放路径
define('RT_WP_NGINX_HELPER_CACHE_PATH','/dev/shm/nginx-cache');

3.2 Nginx-helper纯代码版

为张戈大佬原创：https://zhang.ge/5112.html，搬运如下

将整段粘贴到 WordPress 主题函数模板文件 functions.php 当中即可。其他功能细项，在代码和原文中都有详细的注释了，自行参考修改

/**
* WordPress Nginx FastCGI 缓存清理代码(Nginx-Helper 纯代码版) By 张戈博客
* 文章地址：https://zhang.ge/5112.html
* 转载请保留原文出处，谢谢合作！
*/
//初始化配置
$logSwitch  = 0;                  //配置日志开关，1 为开启，0 为关闭
$logFile    = '/tmp/purge.log';   //配置日志路径
$cache_path = '/tmp/wpcache';     //配置缓存路径
//清理所有缓存(仅管理员) 范例：http://www.domain.com/?purge=all
if ($_GET['purge'] == 'all' && is_user_logged_in()) {
    if( current_user_can( 'manage_options' )) 
    {
        delDirAndFile($cache_path, 0);
    }
}
//缓存清理选项
add_action('publish_post', 'Clean_By_Publish', 99);                   //文章发布、更新清理缓存
add_action('comment_post', 'Clean_By_Comments',99);                   //评论提交清理缓存(不需要可注释)
add_action('comment_unapproved_to_approved', 'Clean_By_Approved',99); //评论审核清理缓存(不需要可注释)
//文章发布清理缓存函数
function Clean_By_Publish($post_ID){
    $url = get_permalink($post_ID);
    cleanFastCGIcache($url);        //清理当前文章缓存
    cleanFastCGIcache(home_url().'/');  //清理首页缓存(不需要可注释此行)
    //清理文章所在分类缓存(不需要可注释以下 5 行)
    if ( $categories = wp_get_post_categories( $post_ID ) ) {
        foreach ( $categories as $category_id ) {
            cleanFastCGIcache(get_category_link( $category_id ));
        }
    }
    //清理文章相关标签页面缓存(不需要可注释以下 5 行)
    if ( $tags = get_the_tags( $post_ID ) ) {
        foreach ( $tags as $tag ) {
	    cleanFastCGIcache( get_tag_link( $tag->term_id ));
        }
    }
}
// 评论发布清理文章缓存
function Clean_By_Comments($comment_id){
    $comment  = get_comment($comment_id);
    $url      = get_permalink($comment->comment_post_ID);
    cleanFastCGIcache($url);
}
// 评论审核通过清理文章缓存
function Clean_By_Approved($comment)
{
    $url      = get_permalink($comment->comment_post_ID); 
    cleanFastCGIcache($url);
}
//日志记录
function purgeLog($msg)
{
    global $logFile, $logSwitch;
    if ($logSwitch == 0 ) return;
    date_default_timezone_set('Asia/Shanghai');
    file_put_contents($logFile, date('[Y-m-d H:i:s]: ') . $msg . PHP_EOL, FILE_APPEND);
    return $msg;
}
// 缓存文件删除函数
function cleanFastCGIcache($url) {
    $url_data  = parse_url($url);
    global $cache_path;
    if(!$url_data) {
        return purgeLog($url.' is a bad url!' );
    }
    $hash        = md5($url_data['scheme'].'GET'.$url_data['host'].$url_data['path']);
    $cache_path  = (substr($cache_path, -1) == '/') ? $cache_path : $cache_path.'/';
    $cached_file = $cache_path . substr($hash, -1) . '/' . substr($hash,-3,2) . '/' . $hash;
    if (!file_exists($cached_file)) {
        return purgeLog($url . " is currently not cached (checked for file: $cached_file)" );
    } else if (unlink($cached_file)) {
        return purgeLog( $url." *** CLeanUP *** (cache file: $cached_file)");
    } else {
        return purgeLog("- - An error occurred deleting the cache file. Check the server logs for a PHP warning." );
    }
}
/**
 * 删除目录及目录下所有文件或删除指定文件
 * 代码出自 ThinkPHP：http://www.thinkphp.cn/code/1470.html
 * @param str $path   待删除目录路径
 * @param int $delDir 是否删除目录，1 或 true 删除目录，0 或 false 则只删除文件保留目录（包含子目录）
 * @return bool 返回删除状态
 */
function delDirAndFile($path, $delDir = FALSE) {
    $handle = opendir($path);
    if ($handle) {
        while (false !== ( $item = readdir($handle) )) {
            if ($item != "." && $item != "..")
                is_dir("$path/$item") ? delDirAndFile("$path/$item", $delDir) : unlink("$path/$item");
        }
        closedir($handle);
        if ($delDir)
            return rmdir($path);
    }else {
        if (file_exists($path)) {
            return unlink($path);
        } else {
            return FALSE;
        }
    }
}

4.效果展示

启用了Nginx fastcgi_cache后，我们就可以在浏览器Header 头部信息中看到已经命中了。

刷新页面，当前端页面头部header出现如下图所示的HIT，表示命中，fastcgi_cache缓存加速成功配置。

对于已经设置了不缓存的页面，Nginx fastcgi_cache会直接显示BYPASS，我们如果是登录状态那是不显示缓存的

同时，我们设置服务器的缓存路径中也能看到Nginx fastcgi_cache生成的缓存文件。

4.1 效果演示站

如果使用纯代码版的插件，那么也可以实现零插件优化WordPress

memcached+batcache后端，fastcgi前端：https://test.xcbtmw.com/

4.2 多站点设置

如果要开启更多站点缓存，按照上面的教程在对应网站添加即可，注意事项如下：

每个站点的缓存路径（fastcgi_cache_path）和缓存密钥（ keys_zone ）设置为不一样的
同一个顶级域名下面的子域名不需要加上面配置中的第一行，注释掉

fastcgi_cache_key "$scheme$request_method$host$request_uri";