使用 Elixir、Phoenix 与 Absinthe 搭建 GraphQL 服务器：环境准备与项目初始化实战

【免费下载链接】howtographqlThe Fullstack Tutorial for GraphQL项目地址https://gitcode.com/gh_mirrors/ho/howtographql点击查看免费下载本指南是 howtographql 教程 Elixir 后端路线中「Getting Started」章节的完整实战讲解。你将基于 Elixir、Phoenix 与 Absinthe 搭建一个名为 Community 的类 Hacker News 应用以用户提交与投票为核心的内容社区并完成 GraphQL 服务器开发前的全部准备工作环境依赖安装、Phoenix 项目生成、Absinthe 依赖引入、数据表与种子数据初始化。学完本章你便拥有了一个可运行、可继续开发 GraphQL Schema 与 Resolver 的完整项目骨架。章节定位Community 应用与 Elixir 技术栈教程采用的技术组合是 Elixir函数式编程语言与 PhoenixElixir 的 Web 框架并以 Absinthe 作为 GraphQL 的 Elixir 实现来接收并执行经 Phoenix 提交的 GraphQL 查询。Elixir 运行在 Erlang VMBEAM之上以低延迟、分布式与容错能力著称其函数式风格与 GraphQL 的字段解析模型天然契合并发模型也让订阅subscriptions这类能力实现起来非常顺手。这些背景在教程的 0-introduction.md 中有详细阐述你可以在本仓库中继续阅读。本教程在当前仓库中的位置为content/backend/graphql-elixir/配套章节还包括 Schema 定义与查询2-queries.md、变更3-mutations.md与总结4-summary.md站点数据中也将该教程登记为标题graphql-elixir的后端路线教程见 src/data/stacks.ts。第一步安装依赖开始创建项目之前需要先在你的机器上装好以下三样东西Elixir 与 ErlangElixir 编译并运行在 Erlang VM 上因此两者必须同时安装具体安装方式以 Elixir 官方安装指南为准不同操作系统各有对应方案。Postgres本教程使用 Postgres 作为应用的数据库。OS X 用户可以执行brew install postgres快速安装其他操作系统可参考 Postgres 官方的详细安装指南。与一些自带全套脚手架的框架不同Phoenix 工作在普通 Elixir 应用的标准目录结构之内但它提供了自己的生成器用来往项目里添加基础 Phoenix 代码方便你快速起步。安装 Phoenix 项目生成器先通过 mix 安装 Hex 包管理器、rebar 构建工具以及phx_new生成器归档mix local.hex --force \ mix local.rebar --force \ mix archive.install hex phx_new逐条说明这三条命令的作用mix local.hex --force安装或更新Hex——Elixir 的包管理器后续mix deps.get拉取依赖都要依赖它--force跳过交互式确认。mix local.rebar --force安装 rebar——Erlang 生态的构建工具部分依赖在编译时会用到。mix archive.install hex phx_new从 Hex 安装phx_new归档。它是一个生成器归档文件安装后即可在任意目录通过mix phx.new生成新的 Phoenix 项目。第二步生成 Phoenix 应用你要构建的应用名叫 Community可以把它理解成一个迷你版的 Hacker News、Slashdot 之类基于用户提交与投票来展示内容的站点。使用phx.new生成器创建项目提示时输入y确认mix phx.new community --no-assets --no-html这里两个标志位值得说明--no-assets跳过 assetsJavaScript/CSS脚手架。由于我们要做的是一个纯 GraphQL API 后端不需要浏览器端资源。--no-html跳过 HTML 视图与模板。同样是因为后端只对外暴露 JSON 形式的 GraphQL 接口。当生成器询问是否获取并安装依赖时回答y然后cd进入生成的community应用目录继续后续操作。第三步为 GraphQL 添加 Absinthe 依赖要让应用支持 GraphQL还需要在mix.exs文件中追加两个依赖它们位于defp deps do函数内部的依赖列表里{:absinthe, ~ 1.6}, {:absinthe_plug, ~ 1.5}这两个依赖的分工如下absintheElixir 生态的 GraphQL 实现提供完整的 Schema DSL、类型系统、编译期类型检查与 Resolver 机制是后续章节编写 Schema 与查询解析的核心库。absinthe_plug把 Absinthe 接入 Phoenix/Plug HTTP 层的桥梁提供Absinthe.Plug处理 GraphQL 请求与Absinthe.Plug.GraphiQL提供浏览器内的 GraphiQL 调试界面等模块。版本约束采用 Elixir 常见的~语义~ 1.6表示允许 1.6.0且 2.0.0的版本~ 1.5同理保证补丁版本可自动升级但不会跨大版本。追加完成后运行mix deps.get这一步会依据mix.exs从 Hex 拉取并锁定所有依赖包括刚加入的 absinthe 及其传递依赖。第四步生成数据库表与种子数据为了让后续章节查询与变更可以直接在已有数据上开发调试现在就把数据库表结构和初始数据准备好。用 phx.gen.context 生成 News Context 与 Link 表mix phx.gen.context News Link links url:string description:text这条生成器命令的参数含义NewsContext 模块名生成Community.News模块作为业务领域的数据访问入口。LinkSchema 模块名生成Community.News.Link结构体映射到数据表。links数据库表名复数形式。url:string、description:text定义表字段及其 Ecto 类型其中url用字符串、description用文本类型。生成器会产出 Context 模块、Schema 模块以及对应的数据库迁移文件。从后续章节可以看到这些产物的实际用法在 2-queries.md 中查询解析器直接调用News.list_links()获取全部链接在 3-mutations.md 中变更解析器通过News.create_link(args)写入新链接。也就是说Resolver 只负责 GraphQL 层面的参数与结果转换数据库访问全部委托给Community.News中的这些函数——这种间接层在应用成长、其他模块也需要创建链接时会非常有用。写入种子数据向priv/repo/seeds.exs文件中加入以下内容让数据库里有一些基础链接数据alias Community.News.Link alias Community.Repo %Link{url: http://graphql.org/, description: The Best Query Language} | Repo.insert! %Link{url: http://dev.apollodata.com/, description: Awesome GraphQL Client} | Repo.insert!这里先用alias引入Community.News.Link由上一步生成器创建与Community.Repo然后构造两个Link结构体通过管道运算符|交给Repo.insert!写入数据库。insert!的感叹号表示失败时直接抛异常适合种子数据这种必须成功的场景。初始化数据库运行mix ecto.setupecto.setup会依次完成创建数据库、运行所有迁移此时links表随之建立、执行seeds.exs种子数据。执行完成后数据表已创建、迁移已运行应用的数据层就绪。如果之后任何时候想清空一切重新来过只需运行mix ecto.reset该命令会删除并重建数据库、重新跑迁移与种子让环境回到初始状态。排查 Postgres 连接问题如果执行上述命令时遇到 Postgres 连接错误优先检查开发环境配置config/dev.exs中的数据库凭据——包括用户名、密码、主机名、端口与数据库名等设置。默认配置通常假定本机postgres用户可免密连接如果你的本地 Postgres 设置了密码或使用了不同账号需要在这里同步修改。完成初始化接下来做什么到这一步你的开发环境已全部就绪Phoenix 应用community已生成并安装依赖Absinthe 与 Absinthe.Plug 已接入项目links表已通过迁移创建且写入了两条种子链接。接下来的开发主线在后续章节中展开先定义 GraphQL Schema在lib/community_web/schema.ex中建立:link对象与all_links根查询字段注意 Absinthe 的蛇形命名会自动适配 GraphQL 的驼峰写法再编写对应的 Resolver 函数并通过iex -S mix phx.server启动服务器、在 GraphiQL 界面/graphiql路由中测试查询随后实现create_link变更让客户端能够提交新链接。相关完整代码示例与测试步骤可以继续阅读仓库中的 2-queries.md 与 3-mutations.md。赞分享【免费下载链接】howtographqlThe Fullstack Tutorial for GraphQL项目地址https://gitcode.com/gh_mirrors/ho/howtographql点击查看免费下载相关推荐使用 Elixir 与 Absinthe 构建 GraphQL 服务器HowToGraphQL 入门导读与 Schema 驱动开发解析使用 Elixir 与 Absinthe 构建 GraphQL 服务器HowToGraphQL 入门导读与 Schema 驱动开发解析 本篇技术指南是 HowJHipster环境搭建与项目初始化实战指南JHipster环境搭建与项目初始化实战指南 本文是一份全面的JHipster全栈开发平台环境搭建与项目初始化实战指南。详细介绍了JHipster的系统环境要求代码生成开发工具后端前端Daytona使用开始环境初始化与准备过程Daytona使用开始环境初始化与准备过程 概述 Daytona是一个专为AI代码执行设计的开发环境管理器提供安全、隔离的运行环境。本文将详细介绍Dayto上一篇Bebas Neue字体完全指南2025年免费开源标题字体的终极解决方案下一篇EPPlus完整指南.NET开发者的Excel自动化解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考