# 第7章 · 实例：简易博客系统

对应教材第 7 章：把前六章的技术合到一个能用的项目里。

这是全书的**收口项目**。前面每章学一个零件，这一章把零件装成一台机器：

| 前面的章节 | 在这里变成什么 |
|---|---|
| 第1章 路由 | `/`、`/post/<id>`、`/new`、`/login` 四条路由 |
| 第2章 前端 | Bootstrap 本地资源、卡片布局、表单样式 |
| 第3章 模板 | `base.html` 母版继承，`index/detail/new/login` 四个子模板 |
| 第4章 交互 | 发文章的 POST 表单、登录表单 |
| 第5章 数据库 | `User` 和 `Post` 两张表，一对多关系 |
| 第6章 结构 | 应用工厂 `create_app()`、Flask-Login 认证 |

---

## 运行

```bat
cd ch07\ch7
..\..\..\venv\Scripts\python.exe app.py
```

打开 <http://127.0.0.1:5118>。

测试账号：**xie / 123456**（首次运行自动创建，并附带一篇示例文章）

---

## 功能与路由

| 地址 | 方法 | 是否需要登录 | 说明 |
|---|---|---|---|
| `/` | GET | 否 | 文章列表，按 id 倒序 |
| `/post/<int:pid>` | GET | 否 | 文章详情，不存在返回 404 |
| `/new` | GET / POST | **是** | 写新文章 |
| `/del/<int:pid>` | GET | **是** | 删除文章 |
| `/login` | GET / POST | 否 | 登录 |
| `/logout` | GET | 是 | 退出 |

试着在未登录状态下直接访问 <http://127.0.0.1:5118/new>，会被自动跳到登录页 —— 这就是 `@login_required` 的作用。

---

## 数据模型

```python
class User(UserMixin, db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(20), unique=True)
    password_hash = db.Column(db.String(200))
    posts = db.relationship('Post', backref='author')     # 一个用户多篇文章

class Post(db.Model):
    __tablename__ = 'posts'
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(50), nullable=False)
    body = db.Column(db.Text)
    user_id = db.Column(db.Integer, db.ForeignKey('users.id'))   # 外键 → 作者
```

两张表，一对多。`backref='author'` 让 `post.author` 能直接拿到作者对象，
模板里 `{{ p.author.username }}` 就能显示出“谁写的”。

---

## 关键实现

### 1. 扩展先建“无主”对象，再在工厂里绑定

```python
db = SQLAlchemy()              # 模块级：此时还没有 app
login_manager = LoginManager()

def create_app():
    app = Flask(__name__)
    db.init_app(app)           # 工厂里绑定
    login_manager.init_app(app)
    ...
```

这是第 6 章工厂模式的标准写法：**扩展对象与 app 解耦**，一个扩展可以被多个 app 共用。

### 2. 首次运行自动建库 + 灌种子数据

```python
with app.app_context():
    db.create_all()
    if db.session.execute(db.select(User).filter_by(username='xie')).scalar_one_or_none() is None:
        ...
        db.session.commit()
```

`app_context()` 是必须的 —— 在请求之外操作数据库，需要手动推入应用上下文。

### 3. 登录校验

```python
u = db.session.execute(db.select(User).filter_by(username=...)).scalar_one_or_none()
if u and check_password_hash(u.password_hash, request.form['password']):
    login_user(u)
```

**先查用户，再验哈希**。用户不存在和密码错误要给同一句提示（“用户名或密码错误”），
否则攻击者能靠提示差异枚举出哪些用户名存在。

### 4. 模板继承

`base.html` 里挖好坑：

```jinja
{% block content %}{% endblock %}
```

四个子模板各自 `{% extends 'base.html' %}`，导航栏和页脚只写一次。

---

## 这个项目故意没做的事（留作扩展）

教材第 7 章是“简易”博客，所以下面这些都没实现，正好当练习：

| 缺失 | 对应哪一章的知识 |
|---|---|
| 文章分页 | 第5章 `db.paginate()` |
| 编辑文章（只有新增和删除） | 第1章 路由 + 第4章 表单 |
| 富文本正文（现在是纯文本） | 第4章 CKEditor |
| 标签 / 分类 | 第5章 多对多 |
| 只有作者本人能删自己的文章 | 第6章 `current_user` 判断 |
| CSRF 防护（现在手写表单没加 token） | 第4章 Flask-WTF |
| 蓝图拆分（现在路由都挤在 `register_routes` 里） | 第6章 蓝图 |

---

## 常见坑

| 现象 | 原因 | 解决 |
|---|---|---|
| 页面空白 / `no such table: posts` | 数据库没建 | 删掉 `blog.db` 重新运行（会自动重建） |
| 登录后仍显示“未登录” | `SECRET_KEY` 变了，旧 session 失效 | 固定 `SECRET_KEY`，重启后重新登录 |
| `/new` 提交后 400 | 表单字段名和 `request.form[...]` 对不上 | 检查模板里 `name="title"` 和代码 `request.form['title']` |
| 删除按钮点了 404 | 文章 id 不存在 | 正常返回，刷新列表即可 |
| 中文标题乱码 | 数据库连接没设编码 / 文件不是 UTF-8 | SQLite 默认 UTF-8；检查模板编码 |
| 想换端口 | 5118 被占用 | 改 `app.run(port=xxxx)` |

---

## 练习

1. **加分页**：列表页每页 5 篇，用 `db.paginate()` 实现（参考 `ch05/ch5`）。
2. **加编辑**：新增 `/edit/<int:pid>` 路由，GET 显示带原内容的表单，POST 更新并 `commit`。
3. **加权限**：只有作者本人能看到删除按钮，路由里判断 `p.user_id == current_user.id`。
4. **换富文本**：把 `/new` 的 `textarea` 换成第4章的 `CKEditorField`，注意渲染时用 `|safe` 前先做标签过滤。
5. **拆蓝图**：把 `register_routes` 里的路由拆成 `main`（列表/详情）和 `auth`（登录/登出）两个蓝图。
