🚀 灯火通明博客系统
一个简洁、现代、优雅的 PHP Markdown 博客系统
项目地址 https://github.com/jinghong-me/MyBlog
✨ 功能特性
📝 文章管理
- ✅ Markdown 编辑器(Editor.md)
- ✅ 支持文章发布、编辑、删除
- ✅ 文章隐藏/显示
- ✅ 文章列表分组显示
- ✅ 分页显示
🖼️ 媒体管理
- ✅ 图片批量上传
- ✅ 图片管理(预览、删除)
- ✅ 附件管理(下载、删除、PDF预览)
- ✅ 拖拽上传
- ✅ 上传进度提示
🎨 主题系统
- ✅ 多主题支持
- ✅ 后台一键切换主题
- ✅ 基于 Twig 模板引擎
- ✅ 自定义主题开发
🌐 SEO 友好
- ✅ 伪静态支持
- ✅ 优雅的 URL
- ✅ 优雅的 404 页面
- ✅ 响应式设计
- ✅ 移动端适配
🔧 现代化 UI
- ✅ 现代化后台界面
- ✅ 卡片式设计
- ✅ 渐变色主题
- ✅ Toast 通知提示
- ✅ 动画效果
🚀 快速开始
环境要求
- PHP 7.0+
- MySQL 5.7+
- Apache(推荐)或 Nginx
- Composer(PHP 依赖管理)
安装步骤
1. 克隆或下载项目
git clone https://github.com/jinghong-me/MyBlog.git
cd MyBlog
2. 安装依赖
composer install
3. 创建数据库
在 MySQL 中创建数据库:
CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
4. 运行安装向导
访问 http://your-domain/install.php,按照向导完成安装:
- 步骤 1:环境检测
- 步骤 2:数据库配置
- 步骤 3:导入数据库
默认管理员账号:
- 用户名:
admin - 密码:
admin123
⚠️ **请登录后立即修改密码!
5. 配置伪静态(Apache)
项目已包含 .htaccess 文件,确保 Apache 启用了 mod_rewrite。
配置伪静态(Nginx)
在 Nginx 配置中添加:
location / {
if (!-e $request_filename) {
rewrite ^/page/(\d+)$ /index.php?page=$1 last;
rewrite ^/article/(\d+)$ /view.php?id=$1 last;
rewrite ^/archive$ /archive.php last;
}
}
📁 目录结构
blog/
├── admin/ # 后台管理目录
│ ├── index.php # 后台入口
│ ├── manage.php # 文章管理
│ ├── write.php # 写文章
│ ├── images.php # 图片管理
│ ├── attachments.php # 附件管理
│ ├── settings.php # 站点设置
│ ├── login.php # 登录页面
│ └── logout.php # 退出登录
├── assets/ # 静态资源
│ ├── style.css # 前台样式
│ ├── admin.css # 后台样式
│ └── editor.md/ # Markdown 编辑器
├── tpl/ # 模板目录
│ ├── default/ # 默认主题
│ │ ├── index.html
│ │ ├── view.html
│ │ ├── archive.html
│ │ └── 404.html
│ └── README.md # 模板开发文档
├── uploads/ # 上传文件目录
├── vendor/ # Composer 依赖
├── index.php # 前台首页
├── view.php # 文章详情
├── archive.php # 归档页
├── 404.php # 404 处理
├── config.php # 配置文件(请复制 config.example.php)
├── install.php # 安装向导
├── install.sql # 数据库初始化
└── .htaccess # Apache 伪静态
🎯 使用说明
后台管理
访问 /admin/ 进入后台管理。
前台页面
- 首页:
/ - 文章详情:
/article/{id} - 归档:
/archive - 分页:
/page/{page}
模板开发
详见 tpl/README.md。
🎨 主题开发
- 在
/tpl/目录下创建新主题文件夹 - 复制
default/目录下的模板文件 - 修改 HTML 和样式
- 在后台「站点设置」中切换主题
详见 tpl/README.md。
🔒 安全建议
- 安装完成后删除
install.php和install.sql - 修改默认管理员密码
- 保护好
config.php文件,不要提交到公开仓库 - 定期备份数据库
📝 更新日志
v2.0
- ✨ 全新现代化 UI 设计
- 🎨 卡片式布局
- 🖼️ 批量上传功能
- 📢 Toast 通知提示
- 🔗 伪静态支持
- 🎯 优化的用户体验
v1.0
- 📝 基础文章管理
- 🖼️ 图片和附件管理
- 🎨 多主题支持
- 🔐 用户登录系统
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📄 许可证
MIT License
👏 致谢
如果这个项目对你有帮助,请给个 ⭐ Star!