blogme

blogme 是将 tunalog 从 Go 技术栈重构到 PHP 技术栈后的版本，保持原有功能模块、前端风格（Alpine + TocasUI）和 SQLite 存储模型。

技术栈

• PHP 8.1+
• SQLite（PDO）
• 前端：Alpine.js + TocasUI（与原项目一致）
• 架构：MVC（Controller + Repository + Core Service）
• 测试：PHPUnit

已迁移功能

• 初始化向导（/wizard）
• 登录/登出（/login、/admin/logout）
• 后台管理：
  • 用户管理
  • 文章管理（创建/编辑/回收站/删除/置顶/密码文章）
  • 标签管理
  • 导航管理
  • 站点设置
  • 外观设置
  • 图片库上传/删除
• 前台：
  • 首页列表
  • 文章详情（含密码解锁）
  • 标签/作者/归档过滤
  • RSS 输出（/rss.xml）
  • 404 主题页
• CLI：
  • 导出 Markdown：php cli.php export-markdown
  • 重置密码：php cli.php reset-password <email>

项目结构

blogme/
├─ app/
│  ├─ Controllers/
│  ├─ Core/
│  ├─ Repositories/
│  ├─ Services/
│  └─ Support/
├─ bootstrap/
├─ resources/
│  ├─ templates/
│  └─ locales/
├─ docs/
├─ public/
│  ├─ uploads/
│  ├─ themes/
│  └─ admin/assets/
├─ storage/
├─ tests/
├─ cli.php
└─ composer.json

快速开始

1. 安装依赖

composer install

2. 初始化数据库（可选）

php cli.php migrate

说明：如未执行 migrate，应用会在首次请求时自动初始化数据库。

如需将数据库中的全部文章导出为本地 Markdown 文档，可执行：

php cli.php export-markdown

说明：导出结果默认写入 exports/markdown/，每次执行会先清空目录再全量重建，文件名格式为 {title} - {type}.md。

3. 启动（开发模式）

php -S 127.0.0.1:8080 -t public dev-router.php

说明：-t public 必须带上。该命令会让内建服务器优先直出 public/ 下的静态资源（如 /themes/*、/admin/assets/*、/uploads/*），其余请求再交给 public/index.php。

4. 首次访问

• 前台：http://127.0.0.1:8080
• 向导：http://127.0.0.1:8080/wizard
• 后台：http://127.0.0.1:8080/admin

数据与配置

• 数据库文件：db.sqlite
• 站点配置：config.json
• 上传目录：public/uploads/（运行期唯一上传目录）
• 主题目录：public/themes/（主题模板、主题本地化、主题静态资源）

目录职责（简化后）

• resources/：项目内置资源（后台模板、基础语言包）
• public/：Web 可访问目录（上传文件、后台静态、主题文件）
  • public/uploads/：用户上传内容（持久化数据）
  • public/admin/assets/：后台静态资源（受 Git 管理）
  • public/themes/：主题目录（模板 + 主题语言 + 主题静态）
  • /assets/*：兼容路径，运行时映射到当前主题的 public/themes/<theme>/assets/*

编辑器与数据链路

• 编辑器改造与 Markdown 持久化链路说明：docs/editor-markdown-pipeline.md
• Mermaid 前后台静态资源与部署约束说明：docs/mermaid-runtime-assets.md
• 若更新后台编辑器资源，请执行：
  • npm install
  • npm run build:admin-editor
• 若更新前台 Mermaid 渲染资源，请执行：
  • npm install
  • npm run build:theme-mermaid

说明：

• 生产环境默认直接发布仓库内已编译好的静态资源，不要求服务器安装 Node.js。
• 对共享虚拟空间，推荐在本地或 CI 预编译后再整体上传 public/admin/assets/ 与 public/themes/default/assets/。
• 前台与后台静态资源应作为物理文件交由 Nginx/Apache 直接承载，不通过 PHP 路由输出。
• 当前前台 Mermaid、Highlight.js 等运行时资源均使用本地静态文件，不依赖外部 CDN。
• 上传时不要只替换单个 *.js 文件；若构建参数后续升级为分包，需保持对应资源目录完整同步。

测试

./vendor/bin/phpunit

部署

共享主机、Apache 重写、权限、备份与上线建议见：

• DEPLOYMENT.md
• docs/backup-and-restore.md