上线之后要做的四件事:可备份、可升级、可回滚、可观测。所有命令以 /www/wwwroot/yecha.org 为例,执行前按你的实际路径替换。
本页导航
备份
B=/root/backup/$(date -u +%Y%m%dT%H%M%SZ); mkdir -p "$B"
mysqldump -h127.0.0.1 -uyecha -p --single-transaction --routines --default-character-set=utf8mb4 yecha \
| gzip > "$B/yecha.sql.gz"
tar czf "$B/site.tar.gz" -C /www/wwwroot yecha.org \
--exclude='var/cache/*' --exclude='var/log/*'
cp -a /www/wwwroot/yecha.org/config.inc.php "$B/config.inc.php.orig"
ls -lh "$B"要点:
- 数据库 + 站点文件 +
config.inc.php三份都要有,缺一份就无法完整恢复;uploads/默认包含在站点包里。 - 备份文件不放 docroot;定期恢复到一台空闲机器做一次真实演练。
- 后台「工具 → 备份」可生成全库备份;「系统升级」一键升级也会先自动备份。
- 删除内容(文章、术语)前单独导出相关表(
ye_contents、ye_relationships、ye_metas、ye_poly_contents),便于误删后精确恢复。
升级
- 备份(上节),并记下当前
YC_VERSION。 - 覆盖内核文件:
index.php、core/、admin/、lang/;保留config.inc.php、uploads/、var/。 - 覆盖或新增主题/插件目录;同名主题先备份再覆盖。
- 迁移:内核
Upgrade::apply()与插件migrations/都是幂等的,启用插件时自动执行;也可 CLI 预演:
php tools/upgrade.php --component core --dry-run
php tools/upgrade.php --component core- 清缓存、重建首页静态件(见缓存)。
- 自检:抽样 10 页 200、5xx 为 0;后台能登录、能保存设置;主题/插件条数与目录数一致;
/sitemap.xml、/feed正常;/en/抽查一页。
回滚
B=/root/backup/<时间戳>
gunzip -c "$B/yecha.sql.gz" | mysql -h127.0.0.1 -uyecha -p yecha
tar xzf "$B/site.tar.gz" -C /www/wwwroot
cp -a "$B/config.inc.php.orig" /www/wwwroot/yecha.org/config.inc.php
php -r 'chdir("/www/wwwroot/yecha.org"); require "config.inc.php"; require "core/bootstrap.php"; Cache::flush("pages"); Cache::flush("blocks");'注意:回滚数据库会覆盖回滚点之后的新内容;先单独导出这段时间内新增的内容再执行。
缓存与静态件
| 位置 | 作用 | 何时清 |
|---|---|---|
var/cache/pages | 全页缓存(home/post/meta_list/…) | 改内容、主题、菜单、导航后 |
var/cache/blocks | 侧栏与区块缓存 | 改侧栏、插件、功能块顺序后 |
var/home-static/ | 首页烘焙件(含 /en/) | 改首页、主题、统计代码后 |
# 清缓存(后台「工具 → 清缓存」同效)
php -r 'chdir("/www/wwwroot/yecha.org"); require "config.inc.php"; require "core/bootstrap.php"; Cache::flush("pages"); Cache::flush("blocks");'
# 重建首页静态件:删掉后由下一次请求按当前主题重新烘焙
rm -f /www/wwwroot/yecha.org/var/home-static/index.html \
/www/wwwroot/yecha.org/var/home-static/en/index.html
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: example.com' http://127.0.0.1/内容页 /changelog 输出 Cache-Control: no-cache,改动即时可见;其他页面若前面有缓存层,按该层规则处理 HTML 缓存与 Cache-Control 一致性。
定时任务
| 任务 | 建议频率 | 作用 |
|---|---|---|
php tools/sync-views.php | 每日 | 把 ye_views 明细回写到 ye_contents.views 并清空明细 |
| 备份脚本 | 每日 | 全库 + 站点文件,异地留存 |
| 首页静态件重建 | 内容变更后 | 或由插件 home-static 自动维护 |
| 站点健康检查 | 每 5 分钟 | /healthz |
30 3 * * * cd /www/wwwroot/yecha.org && php tools/sync-views.php >> var/log/cron.log 2>&1
0 4 * * * /root/bin/yecha-backup.sh >> /var/log/yecha-backup.log 2>&1性能
按 instrument → measure → isolate → fix → re-measure 推进,先量再改。已内置的几个关键优化:
| 点 | 机制 |
|---|---|
| 首页计数 | Front::postsTotal() 优先读 ye_options.stats.posts_total(O(1))→ 缓存(3600s) → 现算兜底;1.2.0 起 home() 不再每请求真跑 COUNT(*) |
| 术语计数 | ye_metas.count 预计算列,列表页直接读;1.2.0 清掉了内置主题里的 SELECT COUNT(*) 子查询 |
| 深翻页 | ye_meta_page_bounds 键序快路径把 offset 数万~百万的查询压到毫秒级;1.2.4 起 tw 也接入,子集不足时安全回退 |
| 索引 | 列表查询依赖 (type,status,deleted_at,published_at,id) 这类有序覆盖索引;改 ORDER BY 前先 EXPLAIN |
| 缓存 | 页缓存与区块缓存命中率、缓存次序(先查缓存再决定是否计算)是首要检查项 |
排查清单(从源站与页面侧找):PHP 渲染与 SQL、PHP-FPM 进程与并发、OPcache 命中、缓存命中、页面资源体积与压缩、图片尺寸与 lazy、TLS 握手与证书链、DNS TTL、第三方外链。
# 慢查询指纹
mysqldumpslow -s t /var/log/mysql/slow.log | head -20
# 源站直出耗时
curl -s -o /dev/null -w 'code=%{http_code} total=%{time_total}s\n' -H 'Host: example.com' http://127.0.0.1/
# PHP 语法与 FPM 状态
php -l core/Front.php监控与告警
/healthz做存活探针;首页、内容页、后台、/sitemap.xml、/feed做多路径拨测。- 关注:5xx 比例、P95 响应时间、PHP-FPM 活跃进程数、慢查询条数、磁盘(缓存/日志/上传)、备份是否成功。
- 每次发布后按升级自检跑一遍;异常优先回滚到上一个可用版本,再离线定位。
故障排查
| 现象 | 排查顺序 |
|---|---|
| 首页空白 / 模板不存在 | 主题 layout.php → 回落日志 var/log/php-error.log → 后台切回 yecha |
| 改了内容前台没变 | 页缓存 / 区块缓存 / 首页静态件三处是否清理 |
| 后台登录后跳回 | HTTPS 判定、站点域名、Cookie;清浏览器 Cookie |
| 后台保存报 500 | DEBUG 临时打开看具体错误、php -l、表结构迁移是否缺列 |
| 列表页突然变慢 | EXPLAIN 看是否退化成全表 filesort;检查计数是否又变成实时子查询 |
| 上传失败 | uploads/ 属主与磁盘空间 |
| 多语页面回退中文 | 译文状态 / 语言前缀 / 术语别名(见多语言) |
| 更新日志没更新 | /changelog 是数据库内容页,改了 CHANGELOG.md 文件不会自动同步(见发版) |
发版规范
仓库 RELEASE.md 是唯一标准,五步强制清单:
- 更新日志检查:根
CHANGELOG.md与线上/changelog内容页(含英文译文)都要写,六要素齐全(根因 / 修复 / 判据 / 验收 / 部署 / 回滚)。 - 功能完全性检查:
php -l、diff 与更新日志一致、改动是否在安装包里(解压后比内容 SHA,gzip 头部时间戳会导致.tar.gz的 SHA 不固定)。 - 出包:
git archive v<版本>打 tar,包内顶层目录yecha-<版本>/。 - GitHub 发布:tag + Release + 上传 tar 资产;token 只用于命令 URL,不写进 git config。
- 收尾:源站与公网抽样验收、清页缓存、更新首页版本徽章、提交 git。
版本号在 core/version.php;/changelog 标题格式固定为 ## YYYY-MM-DD · YeCha <版本> · <标题>,首页「最新更新」区块依赖它解析。