【亲测免费】 ExAdmin 开源项目教程

1、项目介绍

ExAdmin 是一个为 Elixir 和 Phoenix 框架设计的自动管理包。它是一个类似于 Ruby on Rails 中 ActiveAdmin 的工具，旨在通过最少的代码实现 CRUD 管理工具。ExAdmin 允许用户通过运行几个 mix 任务来定义需要管理的 Ecto 模型，从而快速搭建一个功能齐全的管理界面。

2、项目快速启动

安装依赖

首先，确保你已经有一个 Phoenix 项目和一个 Ecto 模型。然后，将 ExAdmin 添加到你的项目依赖中。

使用 Hex 安装

在你的 mix.exs 文件中添加以下依赖：

defp deps do
  [
    {:ex_admin, "~> 0.8"}
  ]
end

使用 GitHub 安装（支持 Ecto 2.0）

defp deps do
  [
    {:ex_admin, github: "smpallen99/ex_admin"}
  ]
end

配置 ExAdmin

在 config/config.exs 文件中添加以下配置：

config :ex_admin,
  repo: MyProject.Repo,
  module: MyProject # 对于 Phoenix >= 1.3.0-rc，使用 MyProject.Web

添加管理模块

在 config/config.exs 文件中添加管理模块：

config :ex_admin,
  modules: [
    MyProject.ExAdmin.Dashboard,
  ]

安装 ExAdmin

运行以下命令来获取依赖并编译：

mix do deps.get, deps.compile

然后，运行以下命令来配置 ExAdmin：

mix admin.install

添加路由

在 web/router.ex 文件中添加 ExAdmin 路由：

defmodule MyProject.Router do
  use MyProject.Web, :router
  use ExAdmin.Router

  scope "/" do
    pipe_through :browser
  end

  scope "/admin", ExAdmin do
    pipe_through :browser
    admin_routes()
  end
end

3、应用案例和最佳实践

应用案例

ExAdmin 可以用于快速搭建后台管理系统，适用于需要管理大量数据的场景，如电商平台的商品管理、用户管理等。

最佳实践

• 自定义模型名称：通过在模块中定义 model_name/0 函数，可以自定义模型的显示名称。
• 使用第三方认证：ExAdmin 将认证工作交给第三方包，如 Coherence。可以参考 Contact Demo Project 的实现。

4、典型生态项目

• Phoenix Framework：ExAdmin 是基于 Phoenix 框架开发的，因此与 Phoenix 框架紧密集成。
• Ecto：ExAdmin 支持 Ecto 1.1 和 Ecto 2.0，可以方便地与 Ecto 模型进行交互。
• Coherence：用于用户认证的第三方包，可以与 ExAdmin 结合使用，提供完整的用户管理功能。

通过以上步骤，你可以快速启动并使用 ExAdmin 项目，构建强大的后台管理系统。