# library-cms-framework

**Repository Path**: xizhaobo/library-cms-framework

## Basic Information

- **Project Name**: library-cms-framework
- **Description**: 图书管理系统。
使用 egg.js + MySql 搭建。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# library-cms-framework

图书管理系统后台。

使用 egg.js + MySql 实现。

### 版本控制

- node v22.14.0
- npm 10.9.2

### 项目初始化

```bash
$ mkdir library-cms-framework && cd library-cms-framework
$ npm init egg --type=simple
$ npm i

$ npm run dev
$ open http://localhost:7001
```

### 项目结构

1. Controller 控制器
2. Service 服务层
3. Router 路由
4. View 视图层 - 由前端项目代替，前后端分离
5. Extend 扩展
6. Config 配置
7. Middleware 中间件

### 安全

1. CSRF 跨域请求伪造

Egg 内置了 CSRF 跨域请求伪造的防范功能，默认是开启的。

在 CSRF 默认配置下，token 会被设置在 Cookie 中。在 AJAX 请求时，可以从 Cookie 中获得 token，并将其放置于 header 中发送服务端。

```
# cookie 设置
csrfToken=3b613T27qBOdbXzQlMJaIFiE

# header 设置
{
  "headers": {
    "x-csrf-token": "csrftoken"
  }
}

# 通过 header 传递 CSRF token 的字段也可以在配置中修改：
// config/config.default.js
module.exports = {
  security: {
    csrf: {
      headerName: 'x-csrf-token', // 通过 header 传递 CSRF token 的默认字段为 x-csrf-token
    },
  },
};
```

### Deploy

```bash
npm start
npm stop
```

### npm scripts

- Use `npm run lint` to check code style.
- Use `npm test` to run unit test.

[egg]: https://eggjs.org