+ 
+ 
+* [Fgprof](./fgprof/README.md) 
+* [Fiberi18n](./fiberi18n/README.md) 
+* [Fibersentry](./fibersentry/README.md) 
+* [Fiberzap](./fiberzap/README.md) 
+* [Fiberzerolog](./fiberzerolog/README.md) 
+* [HCaptcha](./hcaptcha/README.md) 
+* [JWT](./jwt/README.md) 
+* [Loadshed](./loadshed/README.md) 
+* [NewRelic](./fibernewrelic/README.md) 
+* [Open Policy Agent](./opafiber/README.md) 
+* [Otelfiber (OpenTelemetry)](./otelfiber/README.md) 
+* [Paseto](./paseto/README.md) 
+* [Socket.io](./socketio/README.md) 
+* [Swagger](./swagger/README.md) 
+* [Websocket](./websocket/README.md) 
diff --git a/contrib_versioned_docs/version-hcaptcha_v0.x.x/casbin/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/casbin/README.md
new file mode 100644
index 00000000000..6462cc0294a
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/casbin/README.md
@@ -0,0 +1,155 @@
+---
+id: casbin
+---
+
+# Casbin
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+Casbin middleware for Fiber.
+
+**Note: Requires Go 1.18 and above**
+
+## 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-hcaptcha_v0.x.x/fgprof/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fgprof/README.md
new file mode 100644
index 00000000000..74a87f1f259
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fgprof/README.md
@@ -0,0 +1,59 @@
+---
+id: fgprof
+---
+
+# Fgprof
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[fgprof](https://github.com/felixge/fgprof) support for Fiber.
+
+**Note: Requires Go 1.19 and above**
+
+## Install
+
+This middleware supports Fiber v2.
+
+Using fgprof to profiling your Fiber app.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fgprof
+```
+
+## Config
+
+| Property | Type | Description | Default |
+|----------|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|---------|
+| Next | `func(c *fiber.Ctx) bool` | A function to skip this middleware when returned `true`. | `nil` |
+| Prefix | `string`. | Prefix defines a URL prefix added before "/debug/fgprof". Note that it should start with (but not end with) a slash. Example: "/federated-fiber" | `""` |
+
+## Example
+
+```go
+package main
+
+import (
+ "log"
+
+ "github.com/gofiber/contrib/fgprof"
+ "github.com/gofiber/fiber/v2"
+)
+
+func main() {
+ app := fiber.New()
+ app.Use(fgprof.New())
+ app.Get("/", func(c *fiber.Ctx) error {
+ return c.SendString("OK")
+ })
+ log.Fatal(app.Listen(":3000"))
+}
+```
+
+```bash
+go tool pprof -http=:8080 http://localhost:3000/debug/fgprof
+```
diff --git a/contrib_versioned_docs/version-hcaptcha_v0.x.x/fiberi18n/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fiberi18n/README.md
new file mode 100644
index 00000000000..6085548ab1b
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fiberi18n/README.md
@@ -0,0 +1,88 @@
+---
+id: fiberi18n
+---
+
+# Fiberi18n
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[go-i18n](https://github.com/nicksnyder/go-i18n) support for Fiber.
+
+**Note: Requires Go 1.18 and above**
+
+## Install
+
+This middleware supports Fiber v2.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fiberi18n/v2
+```
+
+## Signature
+
+| Name | Signature | Description |
+|--------------|----------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
+| New | `New(config ...*fiberi18n.Config) fiber.Handler` | Create a new fiberi18n middleware handler |
+| Localize | `Localize(ctx *fiber.Ctx, params interface{}) (string, error)` | Localize returns a localized message. param is one of these type: messageID, *i18n.LocalizeConfig |
+| MustLocalize | `MustLocalize(ctx *fiber.Ctx, params interface{}) string` | MustLocalize is similar to Localize, except it panics if an error happens. param is one of these type: messageID, *i18n.LocalizeConfig |
+
+## 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 (
+ "log"
+
+ "github.com/gofiber/contrib/fiberi18n/v2"
+ "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 {
+ localize, err := fiberi18n.Localize(c, "welcome")
+ if err != nil {
+ return c.Status(fiber.StatusInternalServerError).SendString(err.Error())
+ }
+ return c.SendString(localize)
+ })
+ app.Get("/:name", func(ctx *fiber.Ctx) error {
+ return ctx.SendString(fiberi18n.MustLocalize(ctx, &i18n.LocalizeConfig{
+ MessageID: "welcomeWithName",
+ TemplateData: map[string]string{
+ "name": ctx.Params("name"),
+ },
+ }))
+ })
+ log.Fatal(app.Listen(":3000"))
+}
+```
+
diff --git a/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibernewrelic/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibernewrelic/README.md
new file mode 100644
index 00000000000..28f954ce983
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibernewrelic/README.md
@@ -0,0 +1,112 @@
+---
+id: fibernewrelic
+---
+
+# Fibernewrelic
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[NewRelic](https://github.com/newrelic/go-agent) support for Fiber.
+
+**Note: Requires Go 1.18 and above**
+
+## 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)
+ })
+
+ app.Get("/foo", func(ctx *fiber.Ctx) error {
+ txn := newrelic.FromContext(ctx)
+ segment := txn.StartSegment("foo segment")
+ defer segment.End()
+
+ // do foo
+
+ return nil
+ })
+
+ cfg := fibernewrelic.Config{
+ Application: newrelicApp,
+ }
+
+ app.Use(fibernewrelic.New(cfg))
+
+ app.Listen(":8080")
+}
+```
diff --git a/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibersentry/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibersentry/README.md
new file mode 100644
index 00000000000..6291441d9e3
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fibersentry/README.md
@@ -0,0 +1,126 @@
+---
+id: fibersentry
+---
+
+# Fibersentry
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[Sentry](https://sentry.io/) support for Fiber.
+
+**Note: Requires Go 1.18 and above**
+
+## 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 ...fibersentry.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-hcaptcha_v0.x.x/fiberzap/README.md b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fiberzap/README.md
new file mode 100644
index 00000000000..8cbf80517b6
--- /dev/null
+++ b/contrib_versioned_docs/version-hcaptcha_v0.x.x/fiberzap/README.md
@@ -0,0 +1,120 @@
+---
+id: fiberzap
+---
+
+# Fiberzap
+
+
+[](https://gofiber.io/discord)
+
+
+
+
+[Zap](https://github.com/uber-go/zap) logging support for Fiber.
+
+**Note: Requires Go 1.19 and above**
+
+## Install
+
+This middleware supports Fiber v2.
+
+```
+go get -u github.com/gofiber/fiber/v2
+go get -u github.com/gofiber/contrib/fiberzap/v2
+go get -u go.uber.org/zap
+```
+
+### Signature
+
+```go
+fiberzap.New(config ...fiberzap.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"}` |
+| FieldsFunc | `[]zap.Field` | Define a function to add custom fields. | `nil` |
+| 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.