功能路由

函数使用基于文件的路由。你的 /functions 目录结构决定了你的函数将运行的指定路由。你可以根据项目用例的需要创建不同层级的 /functions目录。请查看以下目录：

将根据上述文件结构生成以下路由。这些路由将 URL 模式映射到/functions文件，当访问者访问该 URL 时，将调用该文件：

如果没有匹配到 Function，则会返回到静态资产(如果有的话)。否则，Function 将返回到页面静态资产的默认路由行为。

​​ 动态路由

通过动态路由，你可以将 URL 与参数化网段进行匹配。这对于构建动态应用程序非常有用。你可以通过更改文件名来接受映射到单一路径的动态值。

​​ 单一路径分段

要创建动态路由，请在文件名前后加上一组括号，例如 /users/[user].js。这样做的目的是为单个路径段创建一个占位符：

​​ 多路径段

通过在文件名周围放置两组括号–例如，/users/[[user]].js–就可以匹配/users/之后的任何路由深度：

​​ 动态路由示例

查看以下 /functions/ 目录结构：

以下请求将匹配以下文件：

与占位符 ([user])匹配的 URL 段将出现在请求 context对象中。可使用 context.params对象查找与给定文件名占位符匹配的值。

对于匹配单个 URL 段(使用单组括号)的文件，其值将以字符串形式返回：

对于向 /users/daniel 提出的请求，上述逻辑将返回 daniel。

对于与多个 URL 段(使用双组括号)匹配的文件，其值将以数组形式返回：

对于向 /users/daniel/xyz/123 的请求，上述逻辑将返回 ["daniel", "xyz", "123"]。

​​ 函数调用路线

在纯静态项目中，Pages 提供无限制的免费请求。但是，一旦在 Pages 项目中添加了函数，所有请求都将默认调用你的函数。要继续接收无限制的免费静态请求，请通过创建一个 _routes.json 文件来排除项目的静态路由。使用 Pages CI 或 Wrangler 发布项目时，如果在项目中检测到 functions 目录，该文件就会自动生成。

​​ 创建一个 _routes.json 文件

创建一个 _routes.json文件，以控制函数何时被调用。该文件应放在项目的输出目录中。

该文件将包括三个不同的属性：

• version：定义模式的版本。目前模式只有一个版本(版本 1)，但我们可能会在未来添加更多版本，并力求向后兼容。
• include：定义函数将调用的路由。接受通配符行为。
• exclude：定义函数不会调用的路由。接受通配符行为。exclude总是比 include优先。

​​ 配置示例

下面是 _routes.json的示例。

该 _routes.json将在所有路由上调用你的 Functions。

下面是另一个 _routes.json 文件示例。任何位于 /build 目录内的路由都不会调用函数，也不会产生函数调用费用。

​​ 限制

函数调用路由有以下限制：

• 必须至少有一条包含规则。
• 包含/排除规则合计不得超过 100 条。
• 每条规则不得超过 100 个字符。