Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

middleware

package module

Go to main page

Versions in this module

v1

v1.2.0

Apr 25, 2026

Changes in this version

+ func VerifySignature(opts ...VerifySignatureOption) func(http.Handler) http.Handler

+ type SignatureAlgorithm string

+ const SHA1

+ const SHA256

+ const SHA512

+ type VerifySignatureOption func(*verifySignatureConfig)

+ func WithSignatureAlgorithm(algorithm SignatureAlgorithm) VerifySignatureOption

+ func WithSignatureHeader(headerName string) VerifySignatureOption

+ func WithSignatureSecret(secret string) VerifySignatureOption

v1.1.0

Dec 29, 2025

Changes in this version

+ func RedirectTrailingSlashes(opts ...RedirectTrailingSlashesOption) func(http.Handler) http.Handler

+ func StripTrailingSlashes() func(http.Handler) http.Handler

+ type RedirectTrailingSlashesOption func(*redirectTrailingSlashesConfig)

+ func WithRedirectCode(code int) RedirectTrailingSlashesOption

v1.0.0

Sep 20, 2025

Changes in this version

+ func CacheControl(opts ...CacheControlOption) func(http.Handler) http.Handler

+ func Chain(opts ...ChainOption) func(http.Handler) http.Handler

+ func Compress(opts ...CompressOption) func(http.Handler) http.Handler

+ func CrossOriginProtection() func(http.Handler) http.Handler

+ func ErrorHandler(opts ...ErrorHandlerOption) func(http.Handler) http.Handler

+ func Headers(opts ...HeadersOption) func(http.Handler) http.Handler

+ func RealAddress(opts ...RealAddressOption) func(http.Handler) http.Handler

+ func Recover(opts ...RecoverOption) func(http.Handler) http.Handler

+ func TextLog(opts ...TextLogOption) func(http.Handler) http.Handler

+ type CacheControlOption func(*cacheControlConfig)

+ func WithCacheTimes(cacheTimes map[string]time.Duration) CacheControlOption

+ type ChainOption func(*chainConfig)

+ func WithMiddleware(middleware ...func(http.Handler) http.Handler) ChainOption

+ type CompressOption func(*compressConfig)

+ func WithCompressionCheck(check func(*http.Request) bool) CompressOption

+ func WithGzipLevel(level int) CompressOption

+ type ErrorHandlerOption func(*errorHandlerConfig)

+ func WithClearHeadersOnError(clearHeaders bool) ErrorHandlerOption

+ func WithErrorHandler(statusCode int, handler http.Handler) ErrorHandlerOption

+ type HeadersOption func(*headersConfig)

+ func WithHeader(key, value string) HeadersOption

+ type RealAddressOption func(*realAddressConfig)

+ func WithTrustedProxies(trustedProxies []net.IPNet) RealAddressOption

+ type RecoverOption func(*recoverConfig)

+ func WithPanicLogger(logger RecoverPanicLogger) RecoverOption

+ type RecoverPanicLogger func(r *http.Request, err any)

+ type TextLogFormat int

+ const TextLogFormatCombined

+ const TextLogFormatCommon

+ type TextLogOption func(*textLogConfig)

+ func WithTextLogFormat(format TextLogFormat) TextLogOption

+ func WithTextLogSink(sink func(string)) TextLogOption