Z-BlogPHP静态html生成定时任务脚本

Z-BlogPHP 默认是动态输出页面，每次访问都要经过 PHP 和数据库查询。
开启静态化后能明显降低服务器压力，但手动点“生成”不现实。
本文用零基础也能照做的方式，讲清楚如何写一个静态 HTML 生成脚本，再挂到定时任务上自动跑。

先确认你的 Z-BlogPHP 是否支持静态化

Z-BlogPHP 的静态化能力依赖后台是否开启相关设置。
登录后台，进入“网站设置”或“全局设置”，查找“静态化”或“生成静态”选项。
不同版本和主题下位置略有差异，建议以你当前后台实际显示为准。

如果后台只能生成首页静态，或者主题根本不支持静态化，那定时脚本就没有意义。
这时可以先用插件市场里的静态化插件补齐功能，再继续后面的步骤。

判断条件很简单：手动点一次“生成静态”，看目标目录（通常是网站根目录或 html 子目录）有没有出现 .html 文件。
有文件生成，才说明可以脚本化。

准备一个可被 PHP 调用的生成脚本

Z-BlogPHP 本身没有公开的“一键生成全部静态页”命令行工具，所以常见做法是写一个独立 PHP 脚本，通过引入 Z-BlogPHP 的核心文件来调用生成逻辑。

在网站根目录新建文件 cron_static.php，内容参考如下：

Load();

// 调用静态化生成方法，方法名以主题或插件实际提供的为准
if (method_exists($zbp, 'BuildStatic')) {
    $zbp->BuildStatic();
    echo "static build done\n";
} else {
    echo "BuildStatic method not found\n";
}

这段代码的关键点在于 BuildStatic 方法。
Z-BlogPHP 核心不一定自带这个方法，很多主题会自己封装。
你需要查看主题目录下的 include.php 或 function.php，找到实际负责生成静态页的函数名，替换掉示例里的方法名。

如果找不到现成方法，也可以退一步，用脚本请求首页和栏目页 URL，触发动态页面生成缓存或静态文件。

用宝塔面板挂定时任务

宝塔面板是最省事的方案。
登录宝塔后台，左侧菜单点“计划任务”，新增任务。

任务类型选“访问URL”或“Shell脚本”。
如果选 Shell 脚本，执行命令写：

cd /www/wwwroot/你的域名 && /www/server/php/74/bin/php cron_static.php

PHP 路径要换成你站点实际使用的版本，比如 php/72、php/80。
执行周期可以设成每 10 分钟或每小时一次，具体看你的更新频率。

保存后点“执行”测试一次，看日志里有没有输出 static build done。
如果报 Permission denied，说明 PHP 用户没有写静态目录的权限，需要给 html 目录加写权限：

chown -R www:www /www/wwwroot/你的域名/html
chmod -R 755 /www/wwwroot/你的域名/html

用 Linux Crontab 手动配置

没有宝塔面板时，直接用系统 Crontab。
SSH 登录服务器，执行：

crontab -e

在文件末尾追加一行：

*/10 * * * * cd /www/wwwroot/你的域名 && /usr/bin/php cron_static.php >> /tmp/zb_static.log 2>&1

这行表示每 10 分钟执行一次，并把输出追加到 /tmp/zb_static.log。
日志文件很重要，第一次配置后要打开看：

tail -f /tmp/zb_static.log

如果日志为空，说明命令根本没执行，优先检查 PHP 路径是否正确、Crontab 服务是否在运行。

容易踩坑的几个地方

PHP 路径写错是最常见的问题。
宝塔面板里每个站点可能用不同 PHP 版本，命令里写 php 不一定能找到。
用 which php 或宝塔“软件商店”里确认绝对路径。

权限问题排第二。
定时任务通常以 www 或 root 身份运行，而网站目录属主可能是 www。
如果脚本以 root 跑，生成的文件属主会变成 root，之后网站更新可能失败。
建议统一用 www 用户执行。

脚本超时也要注意。
整站静态页多的时候，一次生成可能跑几十秒甚至几分钟。
PHP 默认 max_execution_time 可能不够，在脚本开头加：

set_time_limit(0);

伪静态冲突容易被忽略。
如果你的服务器已经开了伪静态规则，静态 HTML 文件和动态路由可能打架。
建议把静态文件放在独立目录，并在 Nginx 或 Apache 里加一条优先匹配规则。

怎么确认脚本真的在跑

验证分三层。
第一层看日志：/tmp/zb_static.log 里每隔一段时间应该有新输出。
第二层看文件时间：

ls -lh /www/wwwroot/你的域名/html/ | head

对比修改时间是否和任务周期吻合。
第三层用浏览器访问一个静态页 URL，右键查看页面源码，如果内容是纯静态 HTML 且没有 PHP 报错，基本就成功了。

如果日志一直在输出但文件不更新，多半是 BuildStatic 方法没调对，回到主题文件里核对方法名。

几个常见疑问

定时任务频率设多少合适？ 内容更新不频繁的站点，每小时一次足够；
资讯类站点可以 10 到 30 分钟一次。
频率太高会增加服务器负载，不建议低于 5 分钟。

脚本能生成全部页面吗？ 取决于主题或插件提供的生成范围。
有的只生成首页和栏目页，有的支持全站。
建议先手动执行一次，统计生成文件数量是否符合预期。

为什么宝塔计划任务执行成功但没效果？ 宝塔的“访问URL”类型有时会被防火墙或 CDN 拦截，实际没触发到 PHP。
改用 Shell 脚本类型直接调用 PHP 文件更可靠。

Z-BlogPHP 静态 HTML 生成定时任务脚本的核心就是三步：写一个能调通生成逻辑的 PHP 文件，挂到宝塔或 Crontab 上，再用日志和文件时间验证。
先把手动执行跑通，再交给定时任务，排查会轻松很多。