Loco框架快速入门：构建博客后端实战指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00647/article/details/148443177

Loco框架快速入门：构建博客后端实战指南

loco 🚂 🦀 The one-person framework for Rust for side-projects and startups 项目地址: https://gitcode.com/gh_mirrors/lo/loco

前言

Loco是一个基于Rust语言的现代化Web框架，它提供了快速构建Web应用所需的各种工具和组件。本文将带您快速了解如何使用Loco框架构建一个完整的博客后端系统，包括用户认证和文章CRUD功能。

环境准备

在开始之前，我们需要安装必要的工具链：

cargo install loco
cargo install sea-orm-cli  # 用于数据库操作

这两个命令会安装Loco框架命令行工具和SeaORM数据库迁移工具。

创建新项目

使用以下命令创建一个新的SaaS应用：

loco new

在交互式命令行中，我们需要做出以下选择：

应用名称：例如myblog
应用类型：选择"SaaS App with client side rendering"
数据库提供商：选择Sqlite（简单易用）
后台任务类型：选择Async（基于tokio的异步任务）

项目创建完成后，会生成一个完整的项目结构，包含：

后端API服务
客户端静态资源服务
用户认证系统基础实现

项目结构解析

生成的典型项目结构包含以下重要部分：

myblog/
├── src/            # 主要Rust源代码
│   ├── models/     # 数据模型
│   ├── controllers/ # 控制器
│   └── app.rs      # 应用配置
├── frontend/       # 前端资源
├── migrations/     # 数据库迁移文件
└── tests/          # 测试代码

启动开发服务器

进入项目目录并启动开发服务器：

cd myblog
cargo loco start

如果配置了客户端资源服务，需要先构建前端：

cd frontend
npm install && npm run build

服务器启动后，默认监听5150端口，终端会显示Loco的ASCII艺术logo。

添加博客功能

我们将为博客系统添加文章(Post)功能，包括标题和内容字段：

cargo loco generate scaffold post title:string content:text --api

这个命令会自动生成：

Post模型及相关数据库迁移
完整的CRUD控制器
相关API测试

执行数据库迁移：

cargo loco db migrate

测试API功能

现在我们可以测试文章相关的API：

创建新文章：

curl -X POST -H "Content-Type: application/json" -d '{
  "title": "我的第一篇文章",
  "content": "这是使用Loco框架创建的内容"
}' localhost:5150/api/posts

获取文章列表：

curl localhost:5150/api/posts

获取单篇文章（假设ID为1）：

curl localhost:5150/api/posts/1

用户认证系统

Loco自动生成的SaaS应用包含完整的用户认证流程：

1. 用户注册

curl --location 'localhost:5150/api/auth/register' \
     --header 'Content-Type: application/json' \
     --data-raw '{
         "name": "测试用户",
         "email": "user@example.com",
         "password": "12341234"
     }'

注册后会发送验证邮件（开发模式下可在日志查看验证链接）。

2. 用户登录

curl --location 'localhost:5150/api/auth/login' \
     --header 'Content-Type: application/json' \
     --data-raw '{
         "email": "user@example.com",
         "password": "12341234"
     }'

成功登录后会返回JWT令牌，用于后续认证请求。

3. 获取当前用户信息

使用登录获取的令牌访问受保护端点：

curl --location --request GET 'localhost:5150/api/auth/current' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer YOUR_TOKEN_HERE'