请求

• 简介
• 与请求交互
  • 获取请求路径
  • 获取请求 URL
  • 获取请求 HOST
  • 获取完整 URL
  • 获取请求方法
  • 获取请求头
  • 获取 IP 地址
• 输入
  • 获取所有输入数据
  • 获取路由中的参数
  • 获取路由传入的参数
  • 检索一个输入值
  • json/form 绑定 struct
• Cookie
  • 获取 Cookie
• 文件
  • 获取上传的文件
  • 储存上传的文件
  • 中断请求
  • 获取原始 Request
  • 附加数据
  • 获取数据
  • 获取 Context

简介

Goravel 的 contracts/http/Request 方法可以与应用程序处理的当前 HTTP 请求进行交互，以及检索与请求一起提交的输入内容和文件。

与请求交互

http.Context 实例被自动注入到控制器中：

import "github.com/goravel/framework/contracts/http"

facades.Route().Get("/", func(ctx http.Context) {

})

获取请求路径

path := ctx.Request().Path() // /users

获取请求 URL

url := ctx.Request().Url() // /users?name=Goravel

获取请求 HOST

url := ctx.Request().Host()

获取完整 URL

url := ctx.Request().FullUrl() // http://**/users?name=Goravel

获取请求方法

method := ctx.Request().Method()

获取请求头

header := ctx.Request().Header("X-Header-Name", "default")
headers := ctx.Request().Headers()

获取 IP 地址

ip := ctx.Request().Ip()

输入

获取所有输入数据

可以使用 All 方法以 map[string]any 的形式检索所有传入请求的输入数据，是 json， form 和 query 的合集（优先级由前到后）。

data := ctx.Request().All()

获取路由中的参数

// /users/{id}
id := ctx.Request().Route("id")
id := ctx.Request().RouteInt("id")
id := ctx.Request().RouteInt64("id")

获取路由传入的参数

// /users?name=goravel
name := ctx.Request().Query("name")
name := ctx.Request().Query("name", "default")

// /users?id=1
name := ctx.Request().QueryInt("id")
name := ctx.Request().QueryInt64("id")
name := ctx.Request().QueryBool("id")

// /users?names=goravel1&names=goravel2
names := ctx.Request().QueryArray("names")

// /users?names[a]=goravel1&names[b]=goravel2
names := ctx.Request().QueryMap("names")

queries := ctx.Request().Queries()

检索一个输入值

获取所有的用户输入数据，而不用在意用户使用的是哪种 HTTP 动词，不管是什么 HTTP 动词。检索顺序为：json, form。

name := ctx.Request().Input("name")
name := ctx.Request().Input("name", "goravel")
name := ctx.Request().InputInt("name")
name := ctx.Request().InputInt64("name")
name := ctx.Request().InputBool("name")
name := ctx.Request().InputArray("name")
name := ctx.Request().InputMap("name")

json/form 绑定 struct

type User struct {
  Name string `form:"code" json:"code"`
}

var user User
err := ctx.Request().Bind(&user)

var user map[string]any
err := ctx.Request().Bind(&user)

Cookie

获取 Cookie

Goravel 提供了一种简单的方法来处理 cookie。使用 Request 实例上的 Cookie 方法获取 cookie 的值，如果 cookie 不存在，则返回空字符串。也可以在第二个参数上定义一个默认值。

value := ctx.Request().Cookie("name")
value := ctx.Request().Cookie("name", "default") 

文件

获取上传的文件

file, err := ctx.Request().File("file")

储存上传的文件

file, err := ctx.Request().File("file")
file.Store("./public/test.png")

中断请求

ctx.Request().AbortWithStatus(403)
ctx.Request().AbortWithStatusJson(403, http.Json{
  "Hello": "World",
})

获取原始 Request

request := ctx.Request().Origin()

附加数据

ctx.WithValue("user", "Goravel")

获取数据

user := ctx.Value("user")

获取 Context

ctx := ctx.Context()