Repository files navigation

Package handlers is a collection of handlers (aka "HTTP middleware") for usewith Go'snet/http package (or any framework supportinghttp.Handler), including:

• LoggingHandler for logging HTTP requests in the ApacheCommon LogFormat.
• CombinedLoggingHandler for logging HTTP requests in the ApacheCombined LogFormat commonly used byboth Apache and nginx.
• CompressHandler for gzipping responses.
• ContentTypeHandler for validating requests against a list of acceptedcontent types.
• MethodHandler for matching HTTP methods against handlers in amap[string]http.Handler
• ProxyHeaders for populatingr.RemoteAddr andr.URL.Scheme based on theX-Forwarded-For,X-Real-IP,X-Forwarded-Proto and RFC7239Forwardedheaders when running a Go server behind a HTTP reverse proxy.
• CanonicalHost for re-directing to the preferred host when handling multipledomains (i.e. multiple CNAME aliases).
• RecoveryHandler for recovering from unexpected panics.

Other handlers are documentedon the Gorillawebsite.

A simple example usinghandlers.LoggingHandler andhandlers.CompressHandler:

import ("net/http""github.com/gorilla/handlers")funcmain() {r:=http.NewServeMux()// Only log requests to our admin dashboard to stdoutr.Handle("/admin",handlers.LoggingHandler(os.Stdout,http.HandlerFunc(ShowAdminDashboard)))r.HandleFunc("/",ShowIndex)// Wrap our server with our gzip handler to gzip compress all responses.http.ListenAndServe(":8000",handlers.CompressHandler(r))}

BSD licensed. See the included LICENSE file for details.