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 数据库管理系统的工具:

- 在 [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 文件夹并安装其依赖项:
服务器需要一个 .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] 文件夹中找到它:

运行 [2] 文件将创建税款计算服务器使用的 [dbtaxes-2019] 数据库。要查看它,请在 HeidiSQL 中按 F5 刷新显示:
![]() |
数据库 [dbtaxes-2019] 已创建。
4.4. 启动 NestJS 服务器
一旦 .env 文件就位(并且数据库已创建)之后,在 [nestjs-case-study] 文件夹的根目录打开终端,然后编译并启动服务器:
在开发阶段,若希望每次修改源代码后自动重启,请使用:
无论哪种方式,控制台都会显示:
[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¶m2=val2&…] 形式的参数,可以在这里定义;
- 在 [5] 中:如果请求类型是 POST,在这里定义 POST 的值;
在 TypeScript 课程脚本的 [nestjs-course] 文件夹中,您会找到一组可以导入 POSTMAN 的、针对税款计算服务器的 HTTP 请求集合。

操作如下。在 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] 的请求:

请求 [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] 文件中;

服务器的 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 会话:
状态码 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:
{
"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] 结束会话:
现在您已经对 NestJS 税款计算服务器公开的 API 和 JSON 有了很好的了解——它与 PHP 服务器的完全相同。接下来我们可以开始编写查询该服务器的 Dart 脚本了。




























