宝塔WebHook自动清理缓存教程

当您在宝塔面板中通过Git WebHook自动部署代码更新后仍看到旧页面内容，问题往往出在缓存未及时清除；本文系统介绍了四种高效、安全的自动清理方案——从直接调用宝塔命令清空OPcache/Redis/静态缓存，到利用计划任务提升安全性，再到Nginx主动驱逐fastcgi缓存，以及集成Laravel/ThinkPHP原生命令，覆盖主流PHP环境与框架场景，助您实现“代码一更新、页面即生效”的丝滑体验。

如果您在宝塔面板中部署了基于PHP或静态文件的网站，并已配置Git WebHook触发代码更新，但发现页面仍显示旧内容，则很可能是缓存未及时清除。以下是通过WebHook实现代码更新后自动清理缓存的多种方法：

一、使用WebHook脚本调用宝塔内置清理命令

该方法利用宝塔面板提供的命令行工具直接清除指定站点的缓存，无需额外安装组件，适用于LNMP环境中的OPcache、Redis、Memcached及静态文件缓存。

1、进入宝塔面板【网站】→ 选择目标站点 → 点击【设置】→【配置文件】，确认PHP版本路径（如/www/server/php/80/bin/php）。

2、在服务器上创建WebHook处理脚本：/www/wwwroot/webhook-clear-cache.sh，并赋予执行权限：chmod +x /www/wwwroot/webhook-clear-cache.sh。

3、编辑脚本内容如下：

#!/bin/bash
cd /www/wwwroot/your-site-domain
echo "Clearing OPcache..."
/www/server/php/80/bin/php -r "opcache_reset();"
echo "Clearing Redis cache..."
/www/server/redis/src/redis-cli FLUSHDB
echo "Removing static cache files..."
rm -rf /www/wwwroot/your-site-domain/runtime/cache/*
echo "Cache cleared successfully"

4、在Git仓库WebHook配置中，将Payload URL设为指向该脚本的触发接口（例如通过Nginx反向代理或使用宝塔计划任务+curl模拟触发）。

二、通过宝塔计划任务配合WebHook触发器

该方法避免直接暴露脚本路径，利用宝塔自带的计划任务模块作为缓存清理的执行载体，提升安全性。

1、登录宝塔面板，进入【计划任务】→【添加计划任务】。

2、任务类型选择【Shell脚本】，任务名称填写“自动清理站点缓存”，执行周期设为【不周期】（手动触发模式）。

3、在脚本内容框中输入以下命令：

/www/server/php/80/bin/php -r "opcache_reset();"
/www/server/redis/src/redis-cli -n 0 FLUSHDB
rm -rf /www/wwwroot/your-site-domain/storage/framework/cache/*

4、保存后，记录该任务的ID（可在URL中查看，形如id=12）。

5、编写一个轻量级PHP接收脚本/www/wwwroot/webhook-trigger.php，内容为：

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_GET['token']) && $_GET['token'] === 'your_secure_token_here') {
  $task_id = 12;
  exec("bt run_task $task_id 2>&1", $output);
  http_response_code(200);
  echo "Cache cleanup triggered";
}

6、在Git WebHook中配置URL为https://your-domain.com/webhook-trigger.php?token=your_secure_token_here。

三、利用Nginx FastCGI缓存清理模块（需编译支持）

若站点启用了Nginx的fastcgi_cache，需通过特定请求头或自定义指令主动失效缓存，而非简单删除文件。

1、确认Nginx已编译支持ngx_http_fastcgi_cache_purge模块（可通过nginx -V 2>&1 | grep -o with-http_fastcgi_cache_purge验证）。

2、在站点配置文件的server块中添加以下配置：

location ~ /purge(/.*) {
  allow 127.0.0.1;
  deny all;
  fastcgi_cache_purge CACHE_NAME "$scheme$request_method$host$1";
}

3、修改WebHook脚本，在代码拉取完成后执行：

curl -X PURGE "https://your-domain.com/purge/" -H "Host: your-domain.com"

4、确保CACHE_NAME与站点配置中fastcgi_cache_path定义的名称一致。

5、测试清理效果：访问任意页面后执行PURGE请求，再次访问应返回新内容且响应头中X-FastCGI-Cache值变为MIS。

四、对接ThinkPHP/Laravel等框架原生缓存命令

针对使用主流PHP框架构建的应用，可直接调用其Artisan或Think命令完成缓存重置，保证框架层与运行时缓存一致性。

1、确认站点使用Laravel框架，且已正确配置APP_KEY与环境变量。

2、在WebHook脚本中追加以下命令：

cd /www/wwwroot/your-laravel-site
/www/server/php/80/bin/php artisan config:clear
/www/server/php/80/bin/php artisan cache:clear
/www/server/php/80/bin/php artisan view:clear
/www/server/php/80/bin/php artisan route:clear

3、若为ThinkPHP 6项目，替换为：

cd /www/wwwroot/your-thinkphp-site
/www/server/php/80/bin/php think clear --all

4、执行前确保PHP CLI加载了与Web服务器相同的扩展（如pdo_mysql、redis），可通过/www/server/php/80/bin/php -m | grep redis验证。

5、在脚本末尾添加日志记录：echo "$(date): Cache cleared via framework command" >> /www/wwwroot/your-site-domain/storage/logs/webhook.log。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。