Skip to content

4. 安装 NestJS 服务器

本章内容原样转载自 TypeScript 课程:安装 Web 服务器与具体的客户端语言无关,这里安装的服务器是两门课程共同的目标。唯一的区别是,TypeScript 文档中的大量截图(Laragon、HeidiSQL、Postman 的安装,总共约一百张图片)在此不再重复;不过文字内容完整保留。如需分步的图文说明,请参阅文档 [通过示例学习 TypeScript 语言和 NestJS Web 框架入门],其中介绍的安装过程完全相同。

注意:下文有时会提到 PHP 服务器,即课程 [Introduction to the PHP7 Language Through Examples] 中所指的那个服务器。NestJS 服务器实现的服务与该 PHP 服务器相同。

我们将介绍 Dart 中的 HTTP 函数,它们可用于查询 Web 服务器。为了进行测试,我们需要一个 Web 服务器。我们将使用为 TypeScript 课程开发的那个服务器(章节 [Case Study: The Tax Calculation Server in NestJS],本课程不涉及,但仍把该服务器用作目标)。该服务器托管一个 JSON 服务,提供以下服务:

  • [init-session] - GET [main.php?action=init-session&type=json] - 告知服务器我们希望收到 JSON 响应;
  • [authenticate-user] - POST [main.php?action=authenticate-user]:两个 POST 参数 [user, password] 决定是否允许连接到 JSON 服务。默认凭据为 [admin, admin];
  • [calculate-tax] - POST [main.php?action=calculate-tax]:POST 参数 [married, children, salary] 用于计算税款([married]:“yes”或“no”,[children]:纳税人的子女数,[salary]:纳税人的年薪);
  • [list-simulations] - GET [main.php?action=list-simulations] - 列出自会话开始以来进行的模拟;
  • [delete-simulation] - GET [main.php?action=delete-simulation&number=x] - 从模拟列表中删除编号为 x 的模拟;
  • [get-admindata] - GET [main.php?action=get-admindata] - 将与服务器关联的整个数据库检索为一个 JSON 对象;
  • [end-session] - GET [main.php?action=end-session]:结束会话。要开始另一个会话,用户必须发出上面的“init-session”命令。

4.1. 安装 Laragon

2026 年 9 月,Laragon 工具可从 URL [Download Laragon – Fast & Modern Dev Environment ] 获取。Laragon 包含可用于安装 PHP 服务器和 MySQL 数据库管理系统的工具:

Image

  • 在 [1] 中,是 Apache Web 服务器;
  • 在 [2] 中,是 MySQL 数据库管理系统;
  • 在 [3] 中,是一个邮件工具,我们不会使用;
  • [4] 启动所有服务(Apache、MySQL、MailPit);
  • [5] 显示 URL [http://localhost] 对应的网页。默认情况下,该 URL 指向 <laragon-install>\www 文件夹,其中 <laragon-install> 是 Laragon 的安装文件夹;
  • 在 [6] 中,启动 HeidiSQL 工具,用于管理 MySQL 数据库。我们将用此工具创建税款计算服务器所使用的数据库;
  • 在 [7] 中,打开一个终端;Laragon 所需的所有二进制文件都在 PATH 中;
  • 在 [8] 中,打开 Windows 资源管理器窗口,定位到与 URL [http://localhost] 关联的文件夹;

Laragon 安装文件夹包含以下内容:

 
  • 在 [1] 中,[bin] 文件夹包含许多应用程序:
  • 在 [1] 中,是 Apache Web 服务器;
  • 在 [2] 中,是命令行终端;
  • 在 [3] 中,是 [git] 客户端,用于管理项目的不同版本;
  • 在 [4] 中,是数据库管理器;
  • [5],是电子邮件管理器;
  • 在 [6] 中,是 MySQL 数据库管理系统;
  • [7],是另一个 Web 服务器;
  • 在 [8] 中,是 [node.js],用于运行 JavaScript 脚本;
  • [9],是文本编辑器;
  • [10],是 PHP 解释器;
  • [11],是 [Python] 解释器;
  • [12],是缓存服务器;

Laragon 自带一套完整的开发环境。在本课程中,我们只使用 MySQL 数据库管理系统 [6],以及 [heidisql] 对其进行图形化管理;

4.2. NestJS 服务器的安装与配置

在本课程脚本目录的 nestjs-case-study 文件夹中,可以找到一个用于极简税款计算的 NestJS 服务器:

nestjs-case-study/
├── package.json
├── nest-cli.json
├── .env.example
├── create_dbtaxes.sql
├── src/
│   ├── main.ts
│   ├── main.controller.ts
│   ├── app.module.ts
│   ├── actions/
│   ├── config/
│   ├── entities/
│   ├── filters/
│   ├── model/
│   ├── responses/
│   ├── session/
│   └── utilities/
└── views/

此服务器需要安装 Node.js 和 npm(Dart 脚本本身不需要)。进入 nestjs-case-study 文件夹并安装其依赖项:

npm install
注意:此安装只需进行一次,它会创建 `node_modules` 文件夹。然后即可进行下面的配置。

服务器需要一个 .env 文件,用于指定由 Laragon 创建的 MySQL 数据库(见上文)的连接设置以及监听端口。将提供的 .env.example 文件复制为 .env 并按如下方式修改:

PORT=3000
TAX_DATA_SOURCE=mysql
DB_HOST=localhost
DB_PORT=3306
DB_NAME=dbtaxes-2019
DB_USER=admtaxes
DB_PASSWORD=pwdtaxes
CORS_ALLOWED=true
SESSION_SECRET=change-me-in-production
  • PORT:NestJS 服务器的监听端口(默认为 3000)。
  • TAX_DATA_SOURCE:MySQL 表示使用下面创建的数据库;
  • DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD:我们将用 HeidiSQL 创建的 dbtaxes-2019 数据库的连接参数——与上面目录树中所示 create_dbtaxes.sql 脚本中定义的凭据相同;
  • CORS_ALLOWED:允许在不同端口上运行的 Dart(浏览器)客户端发起 CORS 调用。
  • SESSION_SECRET:用于对会话 Cookie 签名的密钥——如果服务器将来要对公众开放,请修改它。

4.3. 创建数据库

要创建 NestJS 服务器所需的 MySQL 数据库,我们使用 Laragon 的一个选项:

 
  • 在 [1] 中,必须启动所有服务;
  • 在 [2] 中,[Database] 选项用于管理数据库;

[Database] 选项会启动一个名为 HeidiSQL 的实用工具:

  • 在 [1] 中,可以选择各种数据库管理系统选项。默认提供的是 MySQL 数据库管理系统,这样就可以了;
  • 在 [2] 中,登录到 HeidiSQL;
  • 在 [1-2] 中,运行 SQL 文件,然后选择 [create_dbtaxes.sql] 文件,您可以在 [nestjs-case-study] 文件夹中找到它:

Image

运行 [2] 文件将创建税款计算服务器使用的 [dbtaxes-2019] 数据库。要查看它,请在 HeidiSQL 中按 F5 刷新显示:

 

数据库 [dbtaxes-2019] 已创建。

4.4. 启动 NestJS 服务器

一旦 .env 文件就位(并且数据库已创建)之后,在 [nestjs-case-study] 文件夹的根目录打开终端,然后编译并启动服务器:

npm run build
npm run start:prod

在开发阶段,若希望每次修改源代码后自动重启,请使用:

npm run start:dev

无论哪种方式,控制台都会显示:

[Nest] ... [NestFactory] Starting Nest application...
[Nest] ... [InstanceLoader] AppModule dependencies initialized
[Nest] ... [RoutesResolver] MainController {/}:
[Nest] ... [RouterExplorer] Mapped {/main.php, ALL} route
[Nest] ... [NestApplication] Nest application successfully started
Tax calculation server (NestJS) started on http://localhost:3000
JSON entry point: http://localhost:3000/main.php?action=init-session&type=json
HTML entry point: http://localhost:3000/main.php?action=init-session&type=html

NestJS 服务器只有一个入口点(main.php,为保持兼容性而保留,尽管它实际上是 NestJS),它接收所有请求,并通过一个 “action” 请求参数来选择要执行的处理:

4.5. HTML 税款计算服务器测试

如果尚未启动,请启动所有 Laragon 服务(用于 MySQL)以及 NestJS 服务器(npm run start:prod 或 npm run start:dev;见上文)。然后在浏览器中请求 URL http://localhost:3000/main.php?action=init-session&type=html ——这与 PHP 服务器的 init-session 操作相同,使用相同的 type=html 参数,只是端口为 3000:

凭据是 admin/admin,与 PHP 服务器完全相同——它们的定义方式也相同,是在服务器代码中,而不是在 config.json 中。输入它们:

填写表单并提交。您将看到如下页面:

页面显示了税款计算结果——该页面确实使用了我们刚刚创建的数据库。左侧菜单中的“List of simulations”链接会显示本次会话的计算历史:

如果得到了这些结果,说明 NestJS 税款计算服务器及其 MySQL 数据库工作正常。现在我们可以用 Dart 客户端查询该服务器了。为此,我们将使用服务器的 JSON 版本。

4.6. 税款计算服务器的 API 和 JSON 版本

4.6.1. Postman 测试

PHP 服务器是用 Postman 桌面工具测试的。同一组请求集合(tax-servers-tests.postman_collection.json,位于 TypeScript 课程脚本的 nestjs-course 文件夹中)在 NestJS 服务器上的工作方式完全相同:API 和 JSON 完全一致——相同的操作、相同的参数、相同的 状态码。在 Postman 中,只需修改每个请求的端口(80 → 3000),或者更简单地,如果您已将其定义为变量,则修改集合中的基础 URL 。

Postman 工具可从 URL [https://www.postman.com/downloads/] 获取。您可能需要创建一个账户。

启动所有 Laragon 服务,然后打开 Postman 桌面应用:

  • 在 [1-2] 中,创建一个 HTTP 请求来查询税款计算服务器;
 
  • 在 [1] 中,可以为 HTTP 请求命名。您可以保存并稍后再次找到它;
  • 在 [2] 中:输入要查询的服务器的 URL;
  • 在 [3] 中:选择 HTTP 请求类型。下面我们将用到其中两种:GET 和 POST;
  • 在 [4] 中:如果请求带有 [?param1=val1&param2=val2&…] 形式的参数,可以在这里定义;
  • 在 [5] 中:如果请求类型是 POST,在这里定义 POST 的值;

在 TypeScript 课程脚本的 [nestjs-course] 文件夹中,您会找到一组可以导入 POSTMAN 的、针对税款计算服务器的 HTTP 请求集合。

Image

操作如下。在 Postman 中,按 [Ctrl-O]:

 
  • 使用链接 [1],从文件夹 [nestjs-course] 中导入文件 [tax-servers-tests.postman_collection.json]:
 
  • 在 [1] 中,是导入的集合的名称;
  • 在 [2] 中,是它的内容。这是针对税款计算服务器(JSON)的一系列 HTTP 请求;

例如,来看名为 [init-session-json-700] 的请求。它用于与服务器启动一个 JSON 会话:

 
  • 在 [1] 中,HTTP 请求是 GET;
  • 在 [2] 中,是被请求的 URL。它请求与服务器启动 JSON 对话;
  • 在 [3-4] 中,可以看到 GET 的参数;
  • 在 [5] 中,将请求发送到税款计算服务器;

发送请求之前,请确保已启动 Laragon 服务。服务器的 JSON 响应如下:

 

现在使用名为 [init-session-703] 的请求:

Image

请求 [1-3] 是无效的。参数必须是 [?action=xx&type=yy] 的形式,其中“type”可以是“html”、“xml”或“json”。类型“x”无法被识别。服务器的 JSON 响应如下:

 

重新发送请求 [init-session-json-700] 以重新启动 JSON 会话。然后发送请求 [authenticate-user-200] 进行身份验证:

  • 在 [1] 中,请求是 POST;
  • 在 [2] 中,是身份验证请求的 URL;
  • 在 [3] 中,是 POST 的请求体,其中包含要发送的值;
  • [4-5],是两个要发送的值。它们是应用程序管理员的凭据,定义在服务器的 [config.service.ts] 文件中;

Image

服务器的 JSON 响应如下:

 

身份验证通过后,就可以进行税款计算了。为此,使用请求 [calculate-tax-300]:

 
  • 在 [1] 中,这是一个 POST 请求;
  • 在 [2] 中,是被调用的 URL;
  • 在 [3-4] 中,发送三个值;

JSON 响应如下:

 

多次运行该请求,每次修改发送的值。完成后,运行请求 [list-simulations-500],它会显示您已进行的模拟列表:

  • GET 请求 [1-4] 只有一个参数:[action]。JSON 响应如下:
 

这就是您已进行的模拟列表。

使用请求 [delete-simulation-600] 删除一个模拟:

  • 在 [2] 中,用 GET 请求该 URL。它包含两个参数:[action, number]。[number] 是要从模拟列表中删除的模拟的编号。这里,编号 0 指列表中的第一个模拟;

服务器的 JSON 响应如下:

 

JSON 响应是删除其中一个模拟之后剩余的模拟列表;

最后,可以用请求 [end-session-400] 结束会话:

 

请求 URL [1-2] 只有参数 [action](3)。JSON 响应如下:

 

4.6.2. curl 测试

我们也可以使用 [curl] 工具来测试服务器的 JSON 服务。以下所有请求都使用同一个 HTTP 会话(-b/-c cookies.txt 选项在 curl 中会在多次调用之间保留会话 Cookie,就像浏览器或 Postman 一样):

我们先用 [init-session] 操作启动一个 JSON 会话:

curl -c cookies.txt "http://localhost:3000/main.php?action=init-session&type=json"
{
  "action": "init-session",
  "status": 700,
  "response": "session started with type [json]"
}

状态码 700 确认会话已启动——这与 PHP 服务器返回的代码相同。现在我们使用 [authenticate-user] 操作进行身份验证——这是一个 POST 请求,URL 中只有一个参数(action),凭据通过 POST 发送:

curl -b cookies.txt -c cookies.txt -X POST "http://localhost:3000/main.php?action=authenticate-user" \
     -d "user=admin&password=admin"
{
  "action": "authenticate-user",
  "status": 200,
  "response": "Authentication successful [admin, admin]"
}

现在可以使用操作 [calculate-tax] 计算税款,同样使用 POST 并带有三个 POST 参数:婚姻状况、子女数、和薪水:

curl -b cookies.txt -c cookies.txt -X POST "http://localhost:3000/main.php?action=calculate-tax" \
     -d "married=yes&children=2&salary=45000"
{
  "action": "calculate-tax",
  "status": 300,
  "response": {
    "married": "yes",
    "children": 2,
    "salary": 45000,
    "tax": 502,
    "surcharge": 0,
    "discount": 857,
    "reduction": 126,
    "rate": 0.14
  }
}

这些值与上一节中浏览器显示的完全相同(税款 502 €、优惠 857 €、减免 126 €、税率 14%)——HTML 和 JSON 两个版本共用同一个计算引擎。模拟列表通过操作 [list-simulations] 获得,这是一个简单的 GET:

curl -b cookies.txt -c cookies.txt "http://localhost:3000/main.php?action=list-simulations"
{
  "action": "list-simulations",
  "status": 500,
  "response": [
    {
      "married": "yes", "children": 2, "salary": 45000,
      "tax": 502, "surcharge": 0, "discount": 857, "reduction": 126, "rate": 0.14
    }
  ]
}

通过修改 POST 的值,多次运行 [calculate-tax] 请求,然后使用 [delete-simulation] 从列表中删除一个模拟(&number=x 表示其序号),并使用 [get-admindata] 以 JSON 格式检索整个数据库(税率档次和计算常量)。最后,用操作 [end-session] 结束会话:

curl -b cookies.txt -c cookies.txt "http://localhost:3000/main.php?action=end-session"
{
  "action": "end-session",
  "status": 400,
  "response": "session deleted"
}

现在您已经对 NestJS 税款计算服务器公开的 API 和 JSON 有了很好的了解——它与 PHP 服务器的完全相同。接下来我们可以开始编写查询该服务器的 Dart 脚本了。