页面显示旧内容是因缓存未清除,可通过四种方式自动清理:一、WebHook脚本调用宝塔命令清OPcache/Redis/静态缓存;二、计划任务配合PHP触发器提升安全性;三、Nginx fastcgi_cache_purge模块主动失效缓存;四、调用Laravel/ThinkPHP原生命令清框架缓存。

如果您在宝塔面板中部署了基于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,内容为:
<?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。










