HTTP 中间件

简介

中间件可以过滤进入应用程序的 HTTP 请求。

定义中间件

你可以在 app/http/middleware 目录中创建自己的中间件，结构如下。

package middleware

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

func Auth() http.Middleware {
  return func(ctx http.Context) {
    ctx.Request().Next()
  }
}

命令创建中间件

./artisan make:middleware Auth

// 支持嵌套文件夹
./artisan make:middleware user/Auth

注册中间件

全局中间件

如果你希望为应用程序的每个 HTTP 请求应用中间件，需在 bootstrap/app.go 文件中的 WithMiddleware 函数中注册全局中间件。

func Boot() contractsfoundation.Application {
	return foundation.Setup().
		WithMiddleware(func(handler configuration.Middleware) {
			handler.Append(
				middleware.Custom(),
			)
		}).
		WithConfig(config.Boot).
		Create()
}

handler 提供了多个函数来管理中间件：

Append(middlewares ...http.Middleware)：将中间件追加到中间件栈的末尾。
GetGlobalMiddleware() []http.Middleware：获取所有全局中间件。
GetRecover() func(ctx http.Context, err any)：获取自定义恢复函数。
Prepend(middlewares ...http.Middleware)：将中间件前置到中间件栈的开头。
Recover(fn func(ctx http.Context, err any)) Middleware：设置自定义恢复函数以处理 panic。
Use(middleware ...http.Middleware) Middleware：用给定的中间件替换当前的中间件栈。

为路由分配中间件

你可以为某一些路由单独注册中间件：

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

facades.Route().Middleware(middleware.Auth()).Get("users", userController.Show)

中断请求

在中间件中，如果需要中断请求，可以使用 Abort 方法。

ctx.Request().Abort()
ctx.Request().Abort(http.StatusNotFound)
ctx.Response().String(http.StatusNotFound, "Not Found").Abort()

HTTP 中间件 ​

简介 ​

定义中间件 ​

命令创建中间件 ​

注册中间件 ​

全局中间件 ​

为路由分配中间件 ​

中断请求 ​