在现代的 Web 应用中，静态文件（如 HTML、CSS、JavaScript 和图像）的发布和管理是非常重要的，因为这些文件是用户在浏览器中渲染页面所必需的组成部分。Fastify 是一个快速的 Node.js Web 框架，它提供了一些功能来简化静态文件的访问和下载。
Fastify 框架概述
Fastify 是一个聚焦于速度和低开销的 Node.js Web 框架，它在 Node.js 标准库的基础上构建，使用 ES2017 语法和异步编程模型。Fastify 提供了一个可定制的插件体系结构，可以使用它来扩展和增强原有的功能。它的主要特性包括：
- 快速的 HTTP 路由器和路由处理器，支持异步和同步处理器函数。
- 内置的 HTTP 错误处理，能够处理来自路由处理器的异常或错误。
- 统一的请求和响应对象，支持类似流式 API 的响应处理。
- 丰富的插件系统，可以轻松地自定义和扩展功能。
我们将使用 Fastify 来实现静态文件的访问和下载功能。
Fastify 静态文件插件
Fastify 提供了一个专门用于处理静态文件的插件，它名为 fastify-static。该插件的功能如下：
- 根据指定的目录和 URL 路径，返回请求的静态文件。
- 支持缓存和漏斗控制。
- 支持文件扩展名映射和默认文件名。
我们先学习一下 fastify-static 的使用方式，然后再进一步讲解具体的实现细节。
-- -------------------- ---- -------
----- ------- - ------------------
----- ------------- - -------------------------
----- --- - ---------
--------------------------- -
----- ----------
------- -----------
--
---------------- ----- -- -
-- ----- -
------------------
---------------
-
------------------- --------- -- -----------------------------------------------
--这段代码使用了 fastify-static 插件将当前目录下的文件作为静态文件路由来提供服务。我们使用 app.register() 方法将插件注册到 Fastify 应用中。插件的配置是一个对象，其中最重要的是 root 和 prefix。root 是静态文件的根目录，prefix 是 URL 中的路径前缀，例如：http://localhost/public/index.html。
现在我们已经理解了快速静态插件的使用方式，下面我们将深入学习一下它的具体实现。
快速静态插件实现
为了更好地理解 fastify-static 的实现，我们先来回顾一下 HTTP 请求处理的基本流程。
- 客户端发送 HTTP 请求到服务器。
- 服务器接收该请求并解析它。
- 服务器查找请求路径对应的处理器（路由处理器或中间件）。
- 处理器处理该请求并返回响应（包含状态码、响应头和响应体）。
- 服务器将响应发送回客户端。
下面我们将学习如何在 Fastify 中实现针对静态文件的请求处理器。具体来说，我们需要解决以下问题：
- 如何定位请求的静态文件。
- 如何处理文件的读取和发送。
- 如何支持缓存和漏斗控制。
- 如何支持文件扩展名映射和默认文件名。
定位静态文件
对于静态文件处理器来说，最重要的任务就是定位请求的静态文件。在普通的路由处理器中，我们可以简单地从 URL 路径中提取参数并使用它们来查找相关数据。但是，对于静态文件来说，我们需要将 URL 路径转换为本地文件路径，然后查找解析后的文件路径。
为了实现这一点，我们需要使用 Node.js 的 path 模块。该模块提供了一些有用的方法，例如 path.join() 和 path.parse()，可以将 URL 路径解析为本地文件路径。
const path = require('path')
const rootPath = path.resolve(root)
function resolvePath(requestPath, prefix) {
const relativePath = path.join('/', prefix || '', requestPath)
return path.normalize(path.join(rootPath, relativePath))
}在这个例子中，root 是指静态文件的根目录，prefix 是 URL 中的路径前缀，在我们的例子中是 /public。我们要将请求的 URL 路径转换为本地文件路径，可通过以下步骤：
- 将前缀添加到请求 URL 路径中。
- 将斜杆作为路径分隔符，并在路径首部添加斜杆。
- 将路径标准化，以解决不同平台上的路径分隔符问题。
- 使用
path.join()方法将路径组合成一个完整的路径。
最终结果是一个本地文件路径，它将用于查找相应的静态文件。现在我们已经知道了如何定位静态文件，下一步是学习如何读取并发送文件。
读取并发送文件
Fastify 通过 reply.sendFile() 方法来处理静态文件的读取和发送。该方法有以下特性：
- 可以自动处理 HTTP 头部。
- 可以开启缓存和漏斗控制。
- 可以限制文件大小和限制下载速度。
- 可以对文件进行本地处理，例如压缩或加密。
最基本的文件发送代码如下：
-- -------------------- ---- -------
----- -------- ------------------ ------ -
--- -
----- ------------------------
- ----- ----- -
-- --------- --- --------------- -
-- ------- ------- -- --- ------
------
-
------------------
-------------------------------- ------ -------
-
-该函数使用 reply.sendFile() 方法来查找并发送指定的文件。如果遇到错误，它将返回 500 状态码并发送错误消息。如果客户端中断请求，它将忽略它。
支持缓存和漏斗控制
缓存和漏斗控制是优化 Web 性能和资源消耗的常见技术。缓存机制使 Web 应用可以减少对服务器的请求，以提高响应时间和减少流量。漏斗控制则可以防止访问频率过高的用户对服务器的过度负荷。
Fastify 提供了内置的缓存支持，可以通过 cacheControl 选项来激活。该选项接受一个字符串，例如 public, max-age=3600，表示启用公共缓存，并在 3600 秒后到期。还可以将选项设置为 true，表示使用默认的缓存策略（public, max-age=86400）。
Fastify 也提供了一个基于 fast-rate-limit 插件的率限制插件，用于实现基于 IP 地址的漏斗控制。它可以根据每个用户的 IP 地址和时间窗口来限制请求的次数和速度。
const fastifyRateLimit = require('fastify-rate-limit')
app.register(fastifyRateLimit, {
max: 100,
timeWindow: '1 minute',
})该代码片段将注册一个基于 IP 地址的限制器，限制每个 IP 地址在 1 分钟内最多发起 100 次请求。在实际的生产环境中，这些值可能需要根据实际需求进行调整。
支持文件扩展名映射和默认文件名
Fastify 静态文件插件支持文件扩展名映射和默认文件名。文件扩展名映射可以将任何 URL 路径映射到对应的文件扩展名，这在服务静态网站中非常有用。默认文件名则可用于缩短 URL，并使 Web 应用更易于使用。
文件扩展名映射和默认文件名可以在 fastify-static 插件的选项中进行配置，例如：
app.register(fastifyStatic, {
root: __dirname,
prefix: '/public/',
extensions: ['html', 'htm'],
index: ['index.html']
})上面的例子将 .html 和 .htm 文件扩展名映射到相应的 URL 路径。它还将 index.html 文件设置为默认文件名，每当请求路径末尾为 / 时，自动服务该文件。
总结
Fastify 提供了一个功能强大且易于使用的静态文件插件，它使开发人员可以轻松地处理静态文件的访问和下载。在本文中，我们对 Fastify 静态文件插件的实现方式进行了详细的说明，并解决了定位文件、读取文件、缓存、漏斗控制、文件扩展名映射和默认文件名等问题。我们希望本文能够有助于您更好地了解和使用 Fastify。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/649f348d48841e9894b9ab36