在当今快节奏的 web 开发世界中,快速部署强大且可扩展的后端 api 服务的能力比以往任何时候都更加重要。本指南将引导您完成使用尖端技术堆栈构建强大的后端 api 服务的过程:cloudflare pages、d1 database、next.JS 和 drizzle orm。
无论您是希望简化工作流程的经验丰富的开发人员,还是渴望深入现代 web 开发的新手,本教程都将为您提供清晰、分步的方法来创建功能齐全的后端 api 服务只需几分钟。
为什么选择这个技术堆栈?
在我们深入实施之前,让我们快速回顾一下为什么这种特定的技术组合如此强大:
-
cloudflare pages:提供无缝部署和全球 cdn 分发。
-
next.js:一个在前端和后端开发方面都很出色的 react 框架。
-
drizzle orm:一种轻量级、类型安全的 orm,与 d1 配合得非常好。
该堆栈不仅提供强大的功能,而且还显着简化了开发和部署过程。
先决条件
在开始我们的全栈应用程序构建之旅之前,让我们确保您的开发环境已准备就绪。以下是您需要的工具和帐户:
- cloudflare 帐户:如果您还没有,请在 cloudflare 上注册一个免费帐户。
- node.js >=v20.11.0
- pnpm >=v8.15.4
这些工具准备就绪后,我们需要安装 wrangler cli,这是 cloudflare 的命令行工具:
npm install -g wrangler
安装后,使用以下命令登录您的 cloudflare 帐户:
wrangler login
此命令将打开一个浏览器窗口并指导您完成 cloudflare 身份验证过程。
您的开发环境现已设置完毕并准备就绪!在接下来的步骤中,我们将使用预先配置的模板项目,这将显着加快我们的开发过程。让我们继续下一步,我们将克隆项目并开始我们的开发之旅!
克隆项目
我们将使用 nextjs-d1-drizzle-cloudflare-pages 中的模板项目。首先,单击“使用此模板”在您自己的存储库中创建一个项目。
按照 readme 说明配置项目并将其部署到 cloudflare。
要执行此操作:
- 导航到模板存储库
- 点击页面顶部的绿色“使用此模板”按钮
- 选择“创建新存储库”
- 配置您的存储库设置(名称、描述等)
- 在本地克隆您的新存储库
- 按照自述文件中的部署说明在 cloudflare 上设置您的项目
该模板为您的全栈应用程序提供了坚实的基础,并且已经设置了 next.js、d1 数据库和 drizzle orm 的所有必要配置。这可以为您在初始项目配置中节省大量时间和精力。
调试api
部署完成后,使用api调试工具测试服务是否正常运行。在本例中,我使用 apidog 编写 api 文档并调试 api。
-
添加 cloudflare pages 地址作为 api 服务请求的基本 url。
-
为全局 api 端点配置身份验证 (auth)
3.测试客户创建端点以将数据插入数据库
-
定义api端点的请求参数
-
使用模拟数据自动生成请求参数
4.验证数据是否成功插入数据库
结论
恭喜!您刚刚使用 cloudflare pages、d1 database、next.js 和 drizzle orm 构建并部署了强大的后端 api 服务。该堆栈为您提供了强大、可扩展且易于维护的解决方案,可满足您的 web 开发需求。
当您继续开发应用程序时,请记住利用 cloudflare 的全局 cdn 来实现最佳性能,实施适当的缓存策略,并利用 drizzle orm 的功能来实现高效的数据库操作。
欢迎在评论区提问!我会耐心解答大家的问题。
资源和参考
- 蜜蜂狗
- 项目 github 存储库
- cloudflare 页面文档
- d1 数据库文档
- next.js 文档
- drizzle orm 文档