启用WP Super Cache纯代码版本之后的一些优化措施

张戈博客在上个月 28 号启用了 WP Super Cache 代码版，几天下来，虽然小问题不断，但是总体感觉非常不错！不管是前台还是后台，速度都有质的提升，着实值得会折腾的人使用。

感兴趣的可以先看下 28 号的具体教程：《WP Super Cache 静态缓存插件纯代码版（兼容多域名网站）》.

下面，简单的说一下启用此功能后遇到的一些问题的解决办法或细项优化。

①、发表评论时并未删除缓存，导致无法显示最新评论；

②、若主题有登陆状态显示，那缓存之后，无论谁打开都显示已登录；

③、WordPress 原生评论框已登录状态将带入缓存当中，效果同上；

④、管理员回复评论也会发送邮件给管理员（①、②项处理 OK 之后发现的问题）;

⑤、无法保存评论者信息，这个是开启缓存之后的诟病，之前已分享过变相解决办法。

以上问题上一篇文章已有具体说明，下面是最新发现的问题：

⑥、居然会缓存评论填表信息；

⑦、缓存清理不够方便；

⑧、缓存没有时间戳；

⑨、发布/更新文章未删除缓存，导致无法显示最新内容;

⑩、开启缓存之后，首页加上 index.php 后缀仍然可以访问，从而造成收录重复；

⑾、会缓存不存在的页面(404)，可能被搜索引擎抓取造成 SEO 影响(缓存之后会是 200 状态)；

⑿、带补充

一、过滤用户信息

针对第⑥条：

今天，用浏览器无痕模式打开留言板意外发现如图尴尬：

之前浏览器一直是有 cookies，所以每次打开时，博客的 js 都会自动加载已保存的信息，也就是我的经常用的信息。今天鬼使神差的试了下无痕模式，才发现了这个 BUG，尼玛把其他人填写的信息都给缓存了，这是泄漏他人隐私啊！而且也对新用户体验很差！

仔细看了下缓存代码，懒得深究为何会缓存用户浏览器的内容，直接在 cache.php 中加入了置空机制，搞定这个问题：

function auto_cache($contents){//回调函数，当程序结束时自动调用此函数
   global $cache_file;
   $fp = fopen($cache_file,'wb');
   //新增替换代码 Start
   //①. 替换已缓存的用户头像路径为默认
   $contents = preg_replace('/<img id="real-time-gravatar" src=".*?"/','<img id="real-time-gravatar" src="//res.zgboke.com/wp-content/themes/HotNewspro/images/default_avatar.jpg"',$contents);
   
   //②. 置空已缓存的用户名称
   $contents = preg_replace('/<input type="text" name="author" id="author" class="commenttext" value=".*" size="22" tabindex="1" \/>/','<input type="text" name="author" id="author" class="commenttext" value="" size="22" tabindex="1" \/>',$contents);

   //③. 置空已缓存的用户邮箱
   $contents = preg_replace('/<input type="text" name="email" id="email" class="commenttext" value=".*" size="22" tabindex="2" \/>/','<input type="text" name="email" id="email" class="commenttext" value="" size="22" tabindex="2" \/>',$contents);
   
   //④. 置空已缓存的用户网址
   $contents = preg_replace('/<input type="text" name="url" id="url" class="commenttext" value=".*" size="22" tabindex="3" \/>/','<input type="text" name="url" id="url" class="commenttext" value="" size="22" tabindex="3" \/>',$contents);
   //新增替换代码 End
   fwrite($fp,$contents);
   fclose($fp);
   chmod($cache_file,0777);
   clean_old_cache(); //生成新缓存的同时，自动删除所有的老缓存。以节约空间。
   return $contents;
}

使用方法：编辑上一篇文章中所说的 cache.php 文件，搜索 function auto_cache()函数，并替换为以上代码即可。

代码原理：就是在缓存内容之前，先将已保存的用户信息置空，这样处理之后，缓存到磁盘里的 html 文件才是纯净无痕的。

替换机制也很简单，就是借用了 php 的正则替换函数：preg_replace()，其语法如下：

preg_replace('/搜索字符串/','替换字符串','全部内容')

比如，需要将 hello word! 替换为 hello zhangge!，则可以这样写：

preg_replace('/world/','zhangge','hello world!')

因此，我需要置空缓存内容中的用户名、邮箱及网址，也就是一个最简单的正则匹配过程，比如替换用户名：

//搜索条件中只用了一个正则匹配，那就是 value=".*"
$contents = preg_replace('/<input type="text" name="author" id="author" class="commenttext" value=".*" size="22" tabindex="1" \/>/','<input type="text" name="author" id="author" class="commenttext" value="" size="22" tabindex="1" \/>',$contents);

所以，如果你在使用代码版的缓存功能之后，发现某些内容被意外缓存了，只要使用这个方法替换掉即可。

二、前台缓存清理

针对第⑦条

清理缓存不方便的问题，我今天写了一个 js+ajax+php 的方法，可以在前台 ajax 删除缓存内容：

①、新增 JS+ajax 代码：

<script type="text/javascript">
var cache = null;
<?php 
    if(is_single()){
	echo "var page_type = 'single';";
	echo "var page_slug = 'null';";
    } else if(is_page()){ 
	$post_data = get_post($post->ID, ARRAY_A);
	$slug = $post_data['post_name'];
	echo "var page_type = 'page';";
	echo "var page_slug = '".$slug."';";
    } else if(is_category()){
        $cat = get_query_var('cat');
        $theCat = get_category($cat);
        echo "var page_slug = '".$theCat->slug."';";
	echo "var page_type = 'category';";
    } else if(is_home()){ 
        echo "var page_type = 'home';";
	echo "var page_slug = 'null';";
    } else {
	echo "var page_type = 'null';";
	echo "var page_slug = 'null';";
    }
echo "var post_id = ".$post->ID.";";
echo "var page_name = cache_".$post->ID.";";
?>
//触发函数：点击 id 为 clean 元素时将清理该页面缓存
$(function(){ 
    $("#clean").click(function(){ 
            CleanUp();
    }); 
});

//ajax 清理函数
function CleanUp(){
    $.ajax({
        type:'POST',
        data:{
            "action": "delcache",
            "page_type": page_type,
            "post_id": post_id,
            "slug": page_slug,
            },
        //ajax 对象文件：cache.php，即上一篇文章中的静态缓存的 php 文件
        url: '/cache.php',
        cache: false, 
        error: function(){ 
            alert('发生意外错误！'); 
            return false; 
        }, 
        success:function(){
            alert('清理成功！确定后将自动刷新本页...');
            location.reload(true);
        }
    }); 
}
</script>

将以上代码添加到主题 footer 或合并到其他 js 当中均可，需要注意的是，在此代码之前必须先正常载入 Jquery。

②、新增 php 代码：

//缓存清理代码（实际使用，请自行修改缓存路径！）
if(isset($_POST['action'])){
    if($_POST['action'] == 'delcache'){
        if($_POST['page_type'] == 'single'){
            $post = $_POST['post_id'];
            $cachefile = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post.".html/index.html";
            $cachedir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post.".html";
        } else if($_POST['page_type'] == 'page') {
            $post = $_POST['slug'];
            $cachefile = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post."/index.html";
            $cachedir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post;
        } else if($_POST['page_type'] == 'category') {
            $post = $_POST['slug'];
            $cachefile = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post."/index.html";
            $cachedir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post;
        } else if($_POST['page_type'] == 'home') { 
            $cachefile = "/home/wwwroot/zhang.ge/cache/zhang.ge/index.html";
        } else {
            exit();
        }
        if($_POST['page_type'] == 'home'){
            if (file_exists($cachefile)) {
                unlink($cachefile);
            }
        } else if($_POST['page_type'] != 'null') {
            if (file_exists($cachefile)) {
                unlink($cachefile);
                rmdir($cachedir);
            }
        } else {
           exit(); 
        }
    }
    exit();
}

将以上代码添加到静态缓存文件 cache.php 的<?php 之后即可。

注意：cache.php 和 js 代码中的 url 对象是 一 一对应的！！这篇文章主要是针对上一篇文章而写的，所以就是 cache.php，如果想改成其他 php 文件，也是可以的，但前提条件是和 js 中 url 对象要一致！

③、新增触发按钮

在文章、单页页面，合适的位置新增一个按钮或超链接，然后将其 id 改为 clean 即可实现点击该按钮时清理当前页面缓存，比如张戈博客将一个图片链接放到了百度分享工具条上(实现全局清理后，我将其移动到了右下角滚动条)：

最简单的写法如下：

<img src="图片路径" id="clean">

你也可以在其他空闲元素上新增一个 id="clean"，总之就是要新增一个 id 为 clean 的元素！在网站前台点击这个元素将清除当前页面的缓存。

三、加入缓存时间

针对第⑧条：

如果缓存页面没有时间戳，会让人分不清楚这个缓存页面是什么时候生成的，因为有时删除了缓存文件，在前台刷新看到的依然是缓存内容（nginx 通常会产生一个 304 的浏览器缓存）！如果有个时间戳，就能更加容易的区分是否是最新的缓存。

解决方法很简单，在缓存时在代码最后新增时间戳即可，和 WP Super Cache 一样！

和上文第一条过滤用户信息的操作一样，找到 auto_cache 函数，如下新增 2 行时间戳代码即可：

function auto_cache($contents){         //回调函数，当程序结束时自动调用此函数
   global $cache_file;
   $fp = fopen($cache_file,'wb');
   $contents = preg_replace('/<img id="real-time-gravatar" src=".*?"/','<img id="real-time-gravatar" src="//res.zgboke.com/wp-content/themes/HotNewspro/images/default_avatar.jpg"',$contents);
   $contents = preg_replace('/<input type="text" name="author" id="author" class="commenttext" value=".*" size="22" tabindex="1" \/>/','<input type="text" name="author" id="author" class="commenttext" value="" size="22" tabindex="1" \/>',$contents);
   $contents = preg_replace('/<input type="text" name="email" id="email" class="commenttext" value=".*" size="22" tabindex="2" \/>/','<input type="text" name="email" id="email" class="commenttext" value="" size="22" tabindex="2" \/>',$contents);
   $contents = preg_replace('/<input type="text" name="url" id="url" class="commenttext" value=".*" size="22" tabindex="3" \/>/','<input type="text" name="url" id="url" class="commenttext" value="" size="22" tabindex="3" \/>',$contents);
   //如下新增 2 行代码即可在缓存页面的最后输出时间戳！
   date_default_timezone_set('Asia/Shanghai'); 
   $contents.="\n<!-- Power By WordPress 纯静态缓存代码，生成日期：".date('Y-m-d h:i:s',time())." -->";  
   fwrite($fp,$contents);
   fclose($fp);
   chmod($cache_file,0777);
   clean_old_cache();                  //生成新缓存的同时，自动删除所有的老缓存。以节约空间。
   return $contents;
}

四、发布时删除缓存

针对第⑨条：

这个问题其实很好解决，只要使用 WordPress 钩子在发布或更新文章时，调用删除缓存函数即可，具体如下：

//发布或更新文章时删除文章、首页和对应分类缓存
function DelSingleCache($post_ID){
    $category = get_the_category();
    $slug = $category[0]->category_nicename;
    if($slug=='itnews' || $slug=='feeling') {
        $real_slug = "others/".$slug;
    } else if ($slug=='web' || $slug=='os' || $slug=='db') {
        $real_slug = "op/".$slug;
    } else {
            $real_slug = $slug;
    }
    $single_file = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post_ID.".html/index.html";
    $single_dir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$post_ID.".html";
    $cat_file = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$real_slug."/index.html";
    $cat_dir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$real_slug;    
    $home_cache = "/home/wwwroot/zhang.ge/cache/zhang.ge/index.html";
    
    $m_single_file = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$post_ID.".html/index.html";
    $m_single_dir = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$post_ID.".html";    
    $m_cat_file = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$real_slug.".html/index.html";
    $m_cat_dir = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$real_slug.".html";          
    $m_home_cache = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/index.html";    
    if (file_exists($single_file)) {
        unlink($single_file);
        rmdir($single_dir);
    }
    if (file_exists($m_single_file)) {
        unlink($m_single_file);
        rmdir($m_single_dir);
    }    
    if (file_exists($home_cache)) {
        unlink($home_cache);
    }
    if (file_exists($m_home_cache)) {
        unlink($m_home_cache);
    }    
    if (file_exists($cat_file)) {
        unlink($cat_file);
        rmdir($cat_dir);
    }
    if (file_exists($m_cat_file)) {
        unlink($m_cat_file);
        rmdir($m_cat_dir);
   }
    exec(EscapeShellCmd("/opt/reload_nginx.sh"));  
}
add_action('publish_post', 'DelSingleCache');

//发布或更新页面时删除页面缓存
function DelPageCache($post_ID){
    $post_data = get_post($post->ID, ARRAY_A);
    $slug = $post_data['post_name'];
    $page_file = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$slug."/index.html";
    $page_dir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$slug;    
    $m_page_file = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$slug."/index.html";
    $m_page_dir = "/home/wwwroot/zhang.ge/cache/m.zhang.ge/".$slug;
    if (file_exists($page_file)) {
        unlink($page_file);
        rmdir($page_dir);
    } 
    if (file_exists($m_page_file)) {
        unlink($m_page_file);
        rmdir($m_page_dir);
    }         
    exec(EscapeShellCmd("/opt/reload_nginx.sh"));  
}
add_action('publish_page', 'DelPageCache');

将以上代码添加到主题目录的 functions.php 中即可实现发布或更新文章(单页面)的时候，删除当前文章(页面)、首页及所在分类的缓存文件，比 WP Super Cache 的那个发布文章删除所有缓存的机制合理多了！！

Ps：关于删除缓存的所有代码中（包括前面的 ajax 清理功能），若存在二级分类，那么分类缓存路径可能需要进一步修改一下，才会更准确，如果你不清楚，那么用上面的代码也没有任何问题！

以下是张戈博客分类缓存路径的改进案例，仅供参考：

//根据张戈博客分类实际情况，itnews/feeling/web/os/db 这些分类都是二级分类，所以需要加上其父分类路径：
if($slug=='itnews' || $slug=='feeling') {
   $real_slug = "others/".$slug;
} else if ($slug=='web' || $slug=='os' || $slug=='db') {
   $real_slug = "op/".$slug;
} else {
   $real_slug = $slug;
}
$cat_file = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$real_slug."/index.html";
$cat_dir = "/home/wwwroot/zhang.ge/cache/zhang.ge/".$real_slug;

五、index.php 跳转

针对第⑩条

今天，在看百度收录的时候，突然看到如下情形：

试了下，没开启缓存的博客在首页后面加上 index.php 访问，是会自动跳到不带 index.php 的，即访问 http://yourdomain.com/index.php 会自动跳到 http://yourdomain.com/。

但是开启这个代码缓存之后，带上 index.php 是不会跳转的，我估计 wp super cache 的缓存也有这个问题。好吧，说下解决办法：

①、最简单的方法：

直接在 robots.txt 里面禁止百度抓取即可（不过不怎么绝对！）：

Disallow: /index.php

Ps：实际上，我的 robots.txt 里面本来就有一条：

Disallow: /*.php$

尼玛百度就是这么任性！！！不遵守协议。

②、301 跳转方法：

试了半天 nginx，发现和之前写的规则存在冲突，无奈之下只好用 php 代码实现 301 跳转：

//避免 index.php 也可以访问带来的 SEO 问题
$the_host = $_SERVER['HTTP_HOST'];
$the_url = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '';
$the_host = strtolower($the_host);
$the_url = strtolower($the_url); 
if($the_url=="/index.php") {
    header('HTTP/1.1 301 Moved Permanently');
    header('Location:http://'.$the_host);
}

将以上代码添加到 cache.php 的<?php 之后即可，当然也可以放到网站根目录的 index.php 的<?php 后面。

如图所示：

保存之后，在访问带 index.php 的首页就能自动跳转到不带 index.php，从而解决了这个困惑。

六、禁止缓存 404

针对第⑾条

当有人有意无意的访问到一些不存在的页面地址时，缓存代码会将 404 页面给缓存成 html。网络上经常有一些恶意扫描软件，对网站进行猜测抓取，进入缓存文件夹可以看到各种奇葩文件夹：

先不说这样的文件夹会不会逼死强迫症。一旦这些奇葩路径被缓存，那么再次被访问，返回的就不再是 404 状态了，而是正常的 200 状态！

典型案例：明明是一个 404 错误，因为被缓存了，就被百度给收录了：

很简单的处理办法：

①、打开主题目录下的 404.php 模板（国产主题大部分有），然后在任意位置插入<!-- 404nocache -->；

②、编辑缓存代码，在 auto_cache 函数里面插入如下代码：

function auto_cache($contents){ //也就是这行后面插入以下代码：如果存在 404nocache 注释就不缓存！
   if (preg_match("/<!-- 404nocache -->/i",$contents,$matches)) {
      rmdir($cache_dir);
      return $contents;
   }

这样处理一下，就完美解决了会缓存 404 不存在页面的问题了！

好了，目前就发现了这几个问题，也一 一解决了，我自己回顾了一下，发现这代码版几乎已经实现了 WP Super Cache 的绝大部分功能，甚至更好！！有时间，我会尝试将其整理开发成比 cos-html-cache、wp super cache 更优秀的缓存插件（YY 一下）！

后续若发现新的问题也会到这里来补充！如果你在使用这个代码版缓存的时候也出现了新问题，也欢迎留言反馈，一遍完善这个代码版缓存功能！偷偷说一句，其实这个缓存代码稍稍修改，理论上同样适合其他 PHP 建站程序（一般人我不告诉他哦~）！