![twdys.jpg](/static/img/d818a99cb66b0c6be84398343c4d36f2.twdys.webp)

提问的艺术极简板

Waline 是一个基于 LeanCloud 的评论系统，它是 Valine 的一个分支，提供了一些改进和新功能。Waline 旨在为博客、网站和其他在线平台提供简洁、安全的评论服务。



# 准备工作
[Waline官网独立部署文档](https://waline.js.org/guide/deploy/vps.html)，官网采用docker独立部署，更为方便快捷。本文讲述在服务器或者自己电脑上用node包的样式来运行（虽然不知道为什么要在自己电脑上运行，但我5点爬起来就这么干了）

Waline的数据库文件 [waline.sql](https://github.com/walinejs/waline/blob/main/assets/waline.sql)
## 环境变量配置参考表

| 环境变量名称 |必填|默认值|备注|
| ---         | --- | --- | --- |
|MYSQL*HOST   |     | 127.0.0.1 | MySQL 服务的地址 |
| MYSQL_PORT    |     | 3306 | MySQL 服务的端口 |
|   MYSQL_DB |   √  |  | MySQL 数据库库名 |
|  MYSQL_USER  |  √   |  | MySQL 数据库的用户名 |
|  MYSQL_PASSWORD  | √    |  | MySQL 数据库的密码 |
|  MYSQL_PREFIX  |     | wl* | MySQL 数据表的表前缀 |
|  MYSQL_CHARSET  |     | utf8mb4	 | MySQL 数据表的字符集 |
|  MYSQL_SSL  |     |  |  是否使用 SSL MYSQL 连接数据库|

## 方法1

在linux操作系统下，可以直接修改主目录下的.bashrc文件
写入

```bash
export MYSQL_HOST=12.12.12.12
export MYSQL_PORT=3306
export MYSQL_DB=waline
```
填写完成后保存文件并执行以下命令刷新：

```bash
source ~/.bashrc
```
该方法是直接导出系统级的环境变量，使waline 服务端可以从process.env对象中顺利读取到，而这样定义的全局环境变量存在一个弊端，就是会污染到全局，可能会干预到其他项目，而且 windows 与 linux 的配置方法各不相同。所以这里并不推荐，而是更推荐使用方案二

## 方法2
在使用Node.js进行项目开发时，可以通过`process.env`对象访问环境变量。而`dotenv`是一个流行的Node.js库，它允许你将环境变量配置在一个`.env`文件中，这个文件通常位于项目的根目录下。使用`dotenv`的好处是不会污染全局环境变量，并且可以使配置和代码分离，便于管理和维护。

1. **安装dotenv**：首先，需要在你的Node.js项目中安装`dotenv`库。
   ```sh
   npm install dotenv
   ```

2. **创建.env文件**：在项目的根目录下创建一个`.env`文件，并在其中定义所需的环境变量。
   ```env
   # .env 文件示例
   MYSQL_HOST=127.0.0.1
   MYSQL_PORT=3306
   MYSQL_DB=waline
   MYSQL_USER=root
   MYSQL_PASSWORD=yourpassword
   ```

3. **创建入口文件**：在入口文件`main.js`顶部引入并配置`dotenv`。
   ```javascript
    / 引入dotenv
    const dotenv = require('dotenv')
    // 调用config方法合并.env环境变量
    dotenv.config()
    // 引入并执行该文件
    require('@waline/vercel/vanilla.js')   ```

使用`dotenv`的好处是，它只在当前项目中有效，不会影响到其他项目或全局环境。此外，`.env`文件通常不会被加入到版本控制系统（如git），这样可以避免敏感信息（如数据库密码）泄露。


至此，项目构建完成，可以在本地启动进行测试

![image.png](/static/img/c49acb7177df380decd914cca8d96957.image.webp)

Waline 服务端独立部署解决方案

![xfsd (1).jpg](/static/img/2f980a5a771e834cf68b88b918fdee0e.xfsd%20(1).webp)



![xfsd (2).jpg](/static/img/bf81aa6936c6c3426d0ef6c33b2c0317.xfsd%20%282%29.webp)

![](/static/img/670e6c89ad08ccbda540d7325ae6a9c1.xfsd%286%29.webp)

![](/static/img/74fcce2a70daaf554db84bafb8f8e75f.xfsd%287%29.webp)

![xfsd (4).jpg](/static/img/b3aed9c29475955b4d9caf761ffac1a4.xfsd%20%284%29.webp)

![xfsd (5).jpg](/static/img/62cfcda455e61c0dd5795922365654d3.xfsd%20%285%29.webp)

![xfsd (5).jpg](/static/img/7aa7087a408053489f2cddd2e30371c8.xfsd%20%283%29.webp)

记-先锋书店

# api开发-更优雅的[规范响应数据]

## 统一响应函数
```node
function sendResponse(res, status, message, data = {}, error = {}) {
    res.json({
        status: status === 200 ? 'success' : 'error',
        code: status,
        message: message,
        data: data,
        error: error
    });
}
```
```node
{
    "status": "success",
    // 描述 HTTP 响应结果：HTTP 状态响应码在 500-599 之间为”fail”，在 400-499 之间为”error”，其它均为”success”
    "code": 200,
    // 包含一个整数类型的 HTTP 响应状态码，也可以是业务描述操作码，比如 200001 表示注册成功
    "message": "操作成功",
    // 多语言的响应描述
    "data": {
    // 实际的响应数据
        "nickname": "Joaquin Ondricka",
        "email": "lowe.chaim@example.org"
    },
    "error": {}
    // 异常时的调试信息
}
```
- 统一的数据响应格式，固定包含：code、status、data、message、error
- 内置 Http 标准状态码支持，同时支持扩展 ResponseCodeEnum 来根据不同业务模块定义响应码
- 响应码 code 对应描述信息 message 支持本地化，支持配置多语言
- 合理地返回 Http 状态码
- 根据 debug 开关，合理返回异常信息、验证异常信息等

## 调用方法
```node
// 处理GET请求，获取用户信息
app.get('/api/sql/', async (req, res) => {
    const userId = req.query.id;
    try {
        const userInfo = await userModule.getUserInfo(userId);
        sendResponse(res, 200, "操作成功", userInfo);
    } catch (error) {
        console.error('Error fetching user info:', error);
        sendResponse(res, 500, "服务器错误", {}, { message: error.message });
    }
});
```

getUserInfo函数是一个SQL查询的函数，返回一个数组
将响应码 描述 数据 都通过通用操作函数来处理，达到规范化的效果

api开发-更优雅的[规范响应数据]

sqli 1-7关

script

msvalidate.01

link

如果你有机会到好望角，请在海边的石头上刻下我的故事👨‍💻