自定义数据库配置

MrDoc 默认使用 `SQLite`数据库作为数据存储的数据库，如果你使用`Sqlite` 数据库，则无需另外配置数据库。

对于非高并发写入使用，推荐使用 Django 自带的 `Sqlite` 数据库，示例站点（https://doc.mrodc.pro) 即是使用 `SQLite` 作为后端数据库。

## 使用其他数据库

如果有配置其他数据库的需求，请首先参照 `Django` 官方文档中支持的数据库的说明：

[https://docs.djangoproject.com/zh-hans/2.2/ref/databases/](https://docs.djangoproject.com/zh-hans/2.2/ref/databases/)

- PostgreSQL 数据库请安装`psycopg2`
- MySQL 数据库请安装`mysqlclient`，MySQL >= 5.7
- Oracle 数据库请安装`cx_Oracle`

安装好相应数据库的 `Python` 绑定库，然后在/MrDoc/config 目录下打开 `config.ini` 文件，填写相应的数据数信息：

```
# engine，指定数据库类型，接受 sqlite、mysql、oracle、postgresql
engine = sqlite
# name 表示数据库的名称
# name = db_name
# user 表示数据库用户名
# user = db_user
# password 表示数据库用户密码
# password = db_pwd
# host 表示数据库主机地址
# host = db_host
# port 表示数据库端口
# port = db_port
```

> 请注意：请务必使用 Django 官方推荐的后端数据库连接器，否则可能会有未知的错误产生！
> 下述操作务必在项目运行之前操作，否则可能会有数据丢失的风险！

然后执行数据库初始化的两条命令：

```
python manage.py makemigrations
```

和：

```
python manage.py migrate
```

## MySQL 示例

### 安装 mysqlclient

```
pip install mysqlclient
```

### 配置数据库连接信息

打开配置文件 /MrDoc/config/config.ini，修改`[database]`项下相关的信息为：

```
[database]
engine = mysql
name = 数据库名
user = 数据库用户名
password = 数据库用户密码
host = 数据库的连接地址
port = 数据库的连接端口
```

### 初始化数据库

执行命令：

```
python manage.py makemigrations
```

和命令：

```
python manage.py migrate
```