+ 
+ 
+* [Fiberi18n](./fiberi18n/README.md)
+* [Fibersentry](./fibersentry/README.md)
+* [Fiberzap](./fiberzap/README.md)
+* [Fiberzerolog](./fiberzerolog/README.md)
+* [JWT](./jwt/README.md)
+* [NewRelic](./fibernewrelic/README.md)
+* [Open Policy Agent](./opafiber/README.md)
+* [Otelfiber (OpenTelemetry)](./otelfiber/README.md)
+* [Paseto](./paseto/README.md)
+* [Swagger](./swagger/README.md)
+* [Websocket](./websocket/README.md)
diff --git a/contrib_versioned_docs/version-jwt_v1.x.x/casbin/README.md b/contrib_versioned_docs/version-jwt_v1.x.x/casbin/README.md
new file mode 100644
index 00000000000..2010a129bc6
--- /dev/null
+++ b/contrib_versioned_docs/version-jwt_v1.x.x/casbin/README.md
@@ -0,0 +1,151 @@
+---
+id: casbin
+title: Casbin
+---
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+Casbin middleware for Fiber.
+
+### Install
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/casbin
+```
+choose an adapter from [here](https://casbin.org/docs/en/adapters)
+```
+go get -u github.com/casbin/xorm-adapter
+```
+
+### Signature
+```go
+casbin.New(config ...casbin.Config) *casbin.Middleware
+```
+
+### Config
+| Property | Type | Description | Default |
+| :--- | :--- | :--- | :--- |
+| ModelFilePath | `string` | Model file path | `"./model.conf"` |
+| PolicyAdapter | `persist.Adapter` | Database adapter for policies | `./policy.csv` |
+| Enforcer | `*casbin.Enforcer` | Custom casbin enforcer | `Middleware generated enforcer using ModelFilePath & PolicyAdapter` |
+| Lookup | `func(*fiber.Ctx) string` | Look up for current subject | `""` |
+| Unauthorized | `func(*fiber.Ctx) error` | Response body for unauthorized responses | `Unauthorized` |
+| Forbidden | `func(*fiber.Ctx) error` | Response body for forbidden responses | `Forbidden` |
+
+### Examples
+- [Gorm Adapter](https://github.com/svcg/-fiber_casbin_demo)
+- [File Adapter](https://github.com/gofiber/contrib/casbin/tree/master/example)
+
+### CustomPermission
+
+```go
+package main
+
+import (
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/contrib/casbin"
+ _ "github.com/go-sql-driver/mysql"
+ "github.com/casbin/xorm-adapter/v2"
+)
+
+func main() {
+ app := fiber.New()
+
+ authz := casbin.New(casbin.Config{
+ ModelFilePath: "path/to/rbac_model.conf",
+ PolicyAdapter: xormadapter.NewAdapter("mysql", "root:@tcp(127.0.0.1:3306)/"),
+ Lookup: func(c *fiber.Ctx) string {
+ // fetch authenticated user subject
+ },
+ })
+
+ app.Post("/blog",
+ authz.RequiresPermissions([]string{"blog:create"}, casbin.WithValidationRule(casbin.MatchAllRule)),
+ func(c *fiber.Ctx) error {
+ // your handler
+ },
+ )
+
+ app.Delete("/blog/:id",
+ authz.RequiresPermissions([]string{"blog:create", "blog:delete"}, casbin.WithValidationRule(casbin.AtLeastOneRule)),
+ func(c *fiber.Ctx) error {
+ // your handler
+ },
+ )
+
+ app.Listen(":8080")
+}
+```
+
+### RoutePermission
+
+```go
+package main
+
+import (
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/contrib/casbin"
+ _ "github.com/go-sql-driver/mysql"
+ "github.com/casbin/xorm-adapter/v2"
+)
+
+func main() {
+ app := fiber.New()
+
+ authz := casbin.New(casbin.Config{
+ ModelFilePath: "path/to/rbac_model.conf",
+ PolicyAdapter: xormadapter.NewAdapter("mysql", "root:@tcp(127.0.0.1:3306)/"),
+ Lookup: func(c *fiber.Ctx) string {
+ // fetch authenticated user subject
+ },
+ })
+
+ // check permission with Method and Path
+ app.Post("/blog",
+ authz.RoutePermission(),
+ func(c *fiber.Ctx) error {
+ // your handler
+ },
+ )
+
+ app.Listen(":8080")
+}
+```
+
+### RoleAuthorization
+
+```go
+package main
+
+import (
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/contrib/casbin"
+ _ "github.com/go-sql-driver/mysql"
+ "github.com/casbin/xorm-adapter/v2"
+)
+
+func main() {
+ app := fiber.New()
+
+ authz := casbin.New(casbin.Config{
+ ModelFilePath: "path/to/rbac_model.conf",
+ PolicyAdapter: xormadapter.NewAdapter("mysql", "root:@tcp(127.0.0.1:3306)/"),
+ Lookup: func(c *fiber.Ctx) string {
+ // fetch authenticated user subject
+ },
+ })
+
+ app.Put("/blog/:id",
+ authz.RequiresRoles([]string{"admin"}),
+ func(c *fiber.Ctx) error {
+ // your handler
+ },
+ )
+
+ app.Listen(":8080")
+}
+```
diff --git a/contrib_versioned_docs/version-jwt_v1.x.x/fiberi18n/README.md b/contrib_versioned_docs/version-jwt_v1.x.x/fiberi18n/README.md
new file mode 100644
index 00000000000..9a38e85d821
--- /dev/null
+++ b/contrib_versioned_docs/version-jwt_v1.x.x/fiberi18n/README.md
@@ -0,0 +1,77 @@
+---
+id: fiberi18n
+title: Fiberi18n
+---
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[go-i18n](https://github.com/nicksnyder/go-i18n) support for Fiber.
+
+### Install
+
+This middleware supports Fiber v2.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fiberi18n
+```
+
+### Signature
+
+```
+fiberi18n.New(config ...*Config) fiber.Handler
+```
+
+### Config
+
+| Property | Type | Description | Default |
+| ---------------- | ------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| Next | `func(c *fiber.Ctx) bool` | A function to skip this middleware when returned `true`. | `nil` |
+| RootPath | `string` | The i18n template folder path. | `"./example/localize"` |
+| AcceptLanguages | `[]language.Tag` | A collection of languages that can be processed. | `[]language.Tag{language.Chinese, language.English}` |
+| FormatBundleFile | `string` | The type of the template file. | `"yaml"` |
+| DefaultLanguage | `language.Tag` | The default returned language type. | `language.English` |
+| Loader | `Loader` | The implementation of the Loader interface, which defines how to read the file. We provide both os.ReadFile and embed.FS.ReadFile. | `LoaderFunc(os.ReadFile)` |
+| UnmarshalFunc | `i18n.UnmarshalFunc` | The function used for decoding template files. | `yaml.Unmarshal` |
+| LangHandler | `func(ctx *fiber.Ctx, defaultLang string) string` | Used to get the kind of language handled by *fiber.Ctx and defaultLang. | Retrieved from the request header `Accept-Language` or query parameter `lang`. |
+
+### Example
+
+```go
+package main
+
+import (
+ "github.com/gofiber/contrib/fiberi18n"
+ "github.com/gofiber/fiber/v2"
+ "github.com/nicksnyder/go-i18n/v2/i18n"
+ "golang.org/x/text/language"
+)
+
+func main() {
+ app := fiber.New()
+ app.Use(
+ fiberi18n.New(&fiberi18n.Config{
+ RootPath: "./example/localize",
+ AcceptLanguages: []language.Tag{language.Chinese, language.English},
+ DefaultLanguage: language.Chinese,
+ }),
+ )
+ app.Get("/", func(c *fiber.Ctx) error {
+ return c.SendString(fiberi18n.MustGetMessage("welcome"))
+ })
+ app.Get("/:name", func(ctx *fiber.Ctx) error {
+ return ctx.SendString(fiberi18n.MustGetMessage(&i18n.LocalizeConfig{
+ MessageID: "welcomeWithName",
+ TemplateData: map[string]string{
+ "name": ctx.Params("name"),
+ },
+ }))
+ })
+ app.Listen("127.0.0.1:3000")
+}
+```
+
diff --git a/contrib_versioned_docs/version-jwt_v1.x.x/fibernewrelic/README.md b/contrib_versioned_docs/version-jwt_v1.x.x/fibernewrelic/README.md
new file mode 100644
index 00000000000..398560f267d
--- /dev/null
+++ b/contrib_versioned_docs/version-jwt_v1.x.x/fibernewrelic/README.md
@@ -0,0 +1,99 @@
+---
+id: fibernewrelic
+title: Fibernewrelic
+---
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[NewRelic](https://github.com/newrelic/go-agent) support for Fiber.
+
+### Install
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fibernewrelic
+```
+
+### Signature
+
+```go
+fibernewrelic.New(config fibernewrelic.Config) fiber.Handler
+```
+
+### Config
+
+| Property | Type | Description | Default |
+|:------------------|:-----------------|:---------------------------------------|:---------------|
+| License | `string` | Required - New Relic License Key | `""` |
+| AppName | `string` | New Relic Application Name | `fiber-api` |
+| Enabled | `bool` | Enable/Disable New Relic | `false` |
+| ~~TransportType~~ | ~~`string`~~ | ~~Can be HTTP or HTTPS~~ (Deprecated) | ~~`"HTTP"`~~ |
+| Application | `Application` | Existing New Relic App | `nil` |
+| ErrorStatusCodeHandler | `func(c *fiber.Ctx, err error) int` | If you want to change newrelic status code, you can use it. | `DefaultErrorStatusCodeHandler` |
+
+### Usage
+
+```go
+package main
+
+import (
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/contrib/fibernewrelic"
+)
+
+func main() {
+ app := fiber.New()
+
+ app.Get("/", func(ctx *fiber.Ctx) error {
+ return ctx.SendStatus(200)
+ })
+
+ cfg := fibernewrelic.Config{
+ License: "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
+ AppName: "MyCustomApi",
+ Enabled: true,
+ }
+
+ app.Use(fibernewrelic.New(cfg))
+
+ app.Listen(":8080")
+}
+```
+
+### Usage with existing New Relic application
+
+```go
+package main
+
+import (
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/contrib/fibernewrelic"
+ "github.com/newrelic/go-agent/v3/newrelic"
+)
+
+func main() {
+ newrelicApp, err := newrelic.NewApplication(
+ newrelic.ConfigAppName("MyCustomApi"),
+ newrelic.ConfigLicense("FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"),
+ newrelic.ConfigEnabled(true),
+ )
+
+ app := fiber.New()
+
+ app.Get("/", func(ctx *fiber.Ctx) error {
+ return ctx.SendStatus(200)
+ })
+
+ cfg := fibernewrelic.Config{
+ Application: newrelicApp
+ }
+
+ app.Use(fibernewrelic.New(cfg))
+
+ app.Listen(":8080")
+}
+```
diff --git a/contrib_versioned_docs/version-jwt_v1.x.x/fibersentry/README.md b/contrib_versioned_docs/version-jwt_v1.x.x/fibersentry/README.md
new file mode 100644
index 00000000000..245a082cc0e
--- /dev/null
+++ b/contrib_versioned_docs/version-jwt_v1.x.x/fibersentry/README.md
@@ -0,0 +1,124 @@
+---
+id: fibersentry
+title: Fibersentry
+---
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[Sentry](https://sentry.io/) support for Fiber.
+
+### Install
+
+This middleware supports Fiber v2.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fibersentry
+go get -u github.com/getsentry/sentry-go
+```
+
+### Signature
+
+```
+fibersentry.New(config ...Config) fiber.Handler
+```
+
+### Config
+
+| Property | Type | Description | Default |
+| :------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------ |
+| Repanic| `bool` | Repanic configures whether Sentry should repanic after recovery. Set to true, if [Recover](https://github.com/gofiber/fiber/tree/master/middleware/recover) middleware is used. | `false` |
+| WaitForDelivery| `bool` | WaitForDelivery configures whether you want to block the request before moving forward with the response. If [Recover](https://github.com/gofiber/fiber/tree/master/middleware/recover) middleware is used, it's safe to either skip this option or set it to false. | `false` |
+| Timeout | `time.Duration` | Timeout for the event delivery requests. | `time.Second * 2` |
+
+
+### Usage
+
+`fibersentry` attaches an instance of `*sentry.Hub` (https://godoc.org/github.com/getsentry/sentry-go#Hub) to the request's context, which makes it available throughout the rest of the request's lifetime.
+You can access it by using the `fibersentry.GetHubFromContext()` method on the context itself in any of your proceeding middleware and routes.
+And it should be used instead of the global `sentry.CaptureMessage`, `sentry.CaptureException`, or any other calls, as it keeps the separation of data between the requests.
+
+**Keep in mind that `*sentry.Hub` won't be available in middleware attached before to `fibersentry`!**
+
+```go
+package main
+
+import (
+ "fmt"
+ "log"
+
+ "github.com/getsentry/sentry-go"
+ "github.com/gofiber/contrib/fibersentry"
+ "github.com/gofiber/fiber/v2"
+ "github.com/gofiber/fiber/v2/utils"
+)
+
+func main() {
+ _ = sentry.Init(sentry.ClientOptions{
+ Dsn: "",
+ BeforeSend: func(event *sentry.Event, hint *sentry.EventHint) *sentry.Event {
+ if hint.Context != nil {
+ if c, ok := hint.Context.Value(sentry.RequestContextKey).(*fiber.Ctx); ok {
+ // You have access to the original Context if it panicked
+ fmt.Println(utils.ImmutableString(c.Hostname()))
+ }
+ }
+ fmt.Println(event)
+ return event
+ },
+ Debug: true,
+ AttachStacktrace: true,
+ })
+
+ app := fiber.New()
+
+ app.Use(fibersentry.New(fibersentry.Config{
+ Repanic: true,
+ WaitForDelivery: true,
+ }))
+
+ enhanceSentryEvent := func(c *fiber.Ctx) error {
+ if hub := fibersentry.GetHubFromContext(c); hub != nil {
+ hub.Scope().SetTag("someRandomTag", "maybeYouNeedIt")
+ }
+ return c.Next()
+ }
+
+ app.All("/foo", enhanceSentryEvent, func(c *fiber.Ctx) error {
+ panic("y tho")
+ })
+
+ app.All("/", func(c *fiber.Ctx) error {
+ if hub := fibersentry.GetHubFromContext(c); hub != nil {
+ hub.WithScope(func(scope *sentry.Scope) {
+ scope.SetExtra("unwantedQuery", "someQueryDataMaybe")
+ hub.CaptureMessage("User provided unwanted query string, but we recovered just fine")
+ })
+ }
+ return c.SendStatus(fiber.StatusOK)
+ })
+
+ log.Fatal(app.Listen(":3000"))
+}
+```
+
+### Accessing Context in `BeforeSend` callback
+
+```go
+sentry.Init(sentry.ClientOptions{
+ Dsn: "your-public-dsn",
+ BeforeSend: func(event *sentry.Event, hint *sentry.EventHint) *sentry.Event {
+ if hint.Context != nil {
+ if c, ok := hint.Context.Value(sentry.RequestContextKey).(*fiber.Ctx); ok {
+ // You have access to the original Context if it panicked
+ fmt.Println(c.Hostname())
+ }
+ }
+ return event
+ },
+})
+```
diff --git a/contrib_versioned_docs/version-jwt_v1.x.x/fiberzap/README.md b/contrib_versioned_docs/version-jwt_v1.x.x/fiberzap/README.md
new file mode 100644
index 00000000000..03e3e6e59ad
--- /dev/null
+++ b/contrib_versioned_docs/version-jwt_v1.x.x/fiberzap/README.md
@@ -0,0 +1,116 @@
+---
+id: fiberzap
+title: Fiberzap
+---
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[Zap](https://github.com/uber-go/zap) logging support for Fiber.
+
+## Install
+
+This middleware supports Fiber v2.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fiberzap
+go get -u go.uber.org/zap
+```
+
+### Signature
+
+```go
+fiberzap.New(config ...Config) fiber.Handler
+```
+
+### Config
+
+| Property | Type | Description | Default |
+|:--------------|:-------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------|
+| Next | `func(*Ctx) bool` | Define a function to skip this middleware when returned true | `nil` |
+| Logger | `*zap.Logger` | Add custom zap logger. | `zap.NewDevelopment()` |
+| Fields | `[]string` | Add fields what you want see. | `[]string{"latency", "status", "method", "url"}` |
+| Messages | `[]string` | Custom response messages. | `[]string{"Server error", "Client error", "Success"}` |
+| Levels | `[]zapcore.Level` | Custom response levels. | `[]zapcore.Level{zapcore.ErrorLevel, zapcore.WarnLevel, zapcore.InfoLevel}` |
+| SkipURIs | `[]string` | Skip logging these URI. | `[]string{}` |
+| GetResBody | func(c *fiber.Ctx) []byte | Define a function to get response body when return non-nil.