【Phoenix】2、初始化 Phoenix 项目后的 目录结构

时间:2021-03-14 05:18:45

  1、当我们创建的时候,Phoenix 为我们建立的根目录架构,如下:

├── _build
├── assets  // 这个是放一下静态文件的,不如 js、css img 和 node_module 依赖包,都是基本放在这里
├── config  // 是放一些配置的,数据库的配置也基本放在这里
├── deps    // 这里应该是放 Elixir 这个语言的依赖包的
├── lib     // 开发主要在这个目录下进行
│   └── hello
│   └── hello_web
│   └── hello.ex
│   └── hello_web.ex
├── priv   // 这个不太清楚
├── test   // 这个估计是测试用的文件夹

 

 

  2、这篇文章的教程,大部分都是在 lib/hello_web 这个目录下进行,目录结构如下:(页面的路由,控件,模板都是在这个目录下)

├── channels // 这个不清楚
│   └── user_socket.ex
├── controllers // 控制器
│   └── page_controller.ex
├── templates  // 模板放的位置
│   ├── layout
│   │   └── app.html.eex
│   └── page
│       └── index.html.eex
└── views // 渲染页面的模块调用位置
│   ├── error_helpers.ex
│   ├── error_view.ex
│   ├── layout_view.ex
│   └── page_view.ex
├── endpoint.ex
├── gettext.ex
├── router.ex // 这个是路由配置文件

   

  3、静态的 js、css、图片 和 依赖包都在 priv/static 的文件夹中

├── assets
│   ├── css
│   │   └── app.css
│   ├── js
│   │   └── app.js
│   └── static
│   └── node_modules
│   └── vendor

  

  4、在本地运行的文件,不在浏览器上传输的在 lib/hello 中

lib ├── hello | ├── application.ex |   └── repo.ex

 

  5、在 lib/hello_web/router.ex 文件中,所有的 http 路径请求 控制,会在这里控制,

// 所有类似的路径请求,都会被 PageController 中的 index 方法处理,模块定义 路径在 lib/hello_web/controllers/page_controller.ex
get "/", PageController, :index

  

  6、下面让我们创建一个 http://localhost:4000/hello 路径的页面,我们先在 router.ex 文件中 scope 里面,新增一个 路径为 /hello 的 get 请求,新增后如下:

scope "/", HelloWeb do pipe_through :browser get "/", PageController, :index get "/hello", HelloController, :index end

  

  7、在 lib/hello_web/controllers 目录下新建一个叫 hello_controller.ex 的文件,内容如下:

defmodule HelloWeb.HelloController do use HelloWeb, :controller // 这里有两个参数 // conn 是一个包含大量请求数据的结构 // params 是请求参数,在这里没有使用,直接 params 会在编译的时候报警告,加上 _ 就可以避免了
  def index(conn, _params) do

    // 这里的意思,是告诉 Phoenix 找到一个 模板叫做 index.html.eex 并且渲染它 // Ps: 这里我们可以在这里用 atom(原子数据) 作为值,例如:render(conn, :index) // 但是 模板 会根据 atom 的值,作为头部,在 index.html / index.json 之间选择
    render(conn, "index.html") end end

 

 

 

 

  8、然后,官方推荐在 view 中处理数据(这我不确定是不是这样理解),所以在 lib/hello_web/views 下面新建一个 hello_view.ex 的文件,内容如下:

defmodule HelloWeb.HelloView do use HelloWeb, :view end

 

  9、Phoenix 中的模板,使用的是 EEx(是 Elixir 的嵌入式,允许嵌入 Elixir 代码到 字符串),文件后缀是 .eex;

     模板的作用域是 一个 view,view 的作用域是 controller,我们最好统一命名,所以创建一个命名空间(也就是创建一个 文件夹);这里创建一个 hello 的文件夹,在 templates 文件夹下,然后在 hello 下创建一个 index.html.eex 文件,内容如下:

 

<div class="phx-hero">
  <h2>第一个 Phoenix 的模板渲染</h2>
</div>

 

   

  10、mix phx.server 运行 Phoenix 服务(如果你已经运行服务了,直接刷新就好了,Phoenix 已经做了热重载),访问路径 http://localhost:4000/hello,我们可以看到下图:

【Phoenix】2、初始化 Phoenix 项目后的 目录结构

 

 

  11、为什么我们只写了一个 简单的 div 标签就看到一整个网页呢?是因为 templates/layout 下面的 app.html.eex 是一整个页面的模板,其中有一句 替换 成我们自己写的模板,就行渲染了。如下:

// 就这一行代码,把我们写的模板替换到这里位置来,进行渲染。暂时只了解到这里,其他的用法之类的。后面学习。
<%= render @view_module, @view_template, assigns %>

【Phoenix】2、初始化 Phoenix 项目后的 目录结构

 

   12、到这里为止,我们的就算是学会了简单的新增路由,和简单的渲染。

 

我是分割线-------------------------------------------------------------------------------------我是分割线

 

  13、先新建一个路由,我们这里是一个动态路由,如下:

// :messager 这个大概都知道是什么了。 // 在 Elixir 中 :messager 中,叫原子,也就是 键值对都是 messager 的值。但在路由中,也就是 messager = 1 的话,动态路由的路径是 /hello/1 了。
get "/hello/:messenger", HelloController, :show

  

  14、新增一个动作,因为我们上面定义的 是 :show ,而不是已经存在的 :index 动作,因为都是 hello 这个路由下,所以我们还在 hello_controller 这个文件中 新增就行了,如下:

  def show(conn, %{"messenger" => messenger}) do render(conn, "show.html", messenger: messenger) end // 新增后 hello_controller.ex 文件的内容,如下: // 这里可能有小白,没空 Elixir 语法就跑过来看了, 我大概讲解一下, // defmodule 空间.名称 do 这个,就是 Elixir 定义模块的方法,模块这个,我也只是大概看了一下,说法不一定对 // def 名称 do 是定义函数的,Elixir 是函数式编程,所以函数式第一公民 // end 是说明这个模块(或者函数),到这里结束。
  defmodule HelloWeb.HelloController do use HelloWeb, :controller def index(conn, _params) do render(conn, "index.html") end def show(conn, %{"messenger" => messenger}) do render(conn, "show.html", messenger: messenger) end end

  

  15、如果动态路由。有多个值,如下:

#hello_controller.ex 文件 def show(conn, %{"messenger" => messenger, "test" => test}) do render(conn, "show.html", messenger: messenger, test: test) end #router.ex 文件 defmodule HelloWeb.Router do use HelloWeb, :router pipeline :browser do plug :accepts, ["html"] plug :fetch_session plug :fetch_flash plug :protect_from_forgery plug :put_secure_browser_headers end pipeline :api do plug :accepts, ["json"] end scope "/", HelloWeb do pipe_through :browser get "/", PageController, :index get "/hello", HelloController, :index get "/hello/:messenger/:test", HelloController, :show end # Other scopes may use custom stacks. # scope "/api", HelloWeb do # pipe_through :api # end end #show.html.eex 文件
// 一个 <%= %> 好像只能嵌入一个 变量
<div class="phx-hero"> <p>Hello World, from <%= @messenger %> 我是测试数据<%= @test %> </p> </div>