下载与安装
YeCha 夜叉:一个「一个 PHP 进程就能跑起来」的极简博客系统。没有框架依赖,没有 Composer 包袱,没有 Node 前端工程——解压、配好数据库、访问一次安装向导,就能开始写字。
环境要求
- PHP 8.1+(开发与线上均在 8.3 / 8.4 验证),需
pdo_mysql / mbstring / simplexml / curl - MySQL 5.7+(建议 8.0),数据库与账号自备
- Nginx / Apache 均可(已内置伪静态与安全规则建议,见部署清单)
- 不需要 Redis、不需要 Composer、不需要 Node
三步安装
- 把程序解压到站点目录,将示例配置改写为你的数据库信息(
config.inc.php)。 - 浏览器访问站点根路径,进入一次性安装向导完成建表与管理员创建。
- 到后台「设置 / 主题 / 页面布局」完善站点信息,写第一篇文章。
升级与备份
- 后台「系统升级」一键升级:先自动全库备份,再逐条执行幂等迁移(
ye_migrations留痕)。 - 「工具 → 备份」可随时导出全库 SQL 到
var/backup,需要时可整库还原。 - CLI 运维:
php tools/upgrade.php(核心迁移)、php tools/sync-views.php(阅读量回写)、php tools/mail-test.php(SMTP 自检)等。
本地体验
仓库自带 docker/ 编排:docker compose up -d 即可起 nginx + php + mysql 的演示环境(默认端口见 docker-compose)。
协议:MIT,可自由使用与二次开发。部署与上线清单参考本站文档索引。