Package cgi
Overview ?
Overview ?
Package cgi implements CGI (Common Gateway Interface) as specified
in RFC 3875.
Note that using CGI means starting a new process to handle each
request, which is typically less efficient than using a
long-running server. This package is intended primarily for
compatibility with existing systems.
Index
- func Request() (*http.Request, error)
- func RequestFromMap(params map[string]string) (*http.Request, error)
- func Serve(handler http.Handler) error
- type Handler
- func (h *Handler) ServeHTTP(rw http.ResponseWriter, req *http.Request)
Package files
child.go
host.go
func Request() (*http.Request, error)
Request returns the HTTP request as represented in the current
environment. This assumes the current program is being run
by a web server in a CGI environment.
The returned Request's Body is populated, if applicable.
func RequestFromMap(params map[string]string) (*http.Request, error)
RequestFromMap creates an http.Request from CGI variables.
The returned Request's Body field is not populated.
func Serve(handler http.Handler) error
Serve executes the provided Handler on the currently active CGI
request, if any. If there's no current CGI environment
an error is returned. The provided handler may be nil to use
http.DefaultServeMux.
type Handler struct {
Path string // path to the CGI executable
Root string
// Dir specifies the CGI executable's working directory.
// If Dir is empty, the base directory of Path is used.
// If Path has no base directory, the current working
// directory is used.
Dir string
Env []string // extra environment variables to set, if any, as "key=value"
InheritEnv []string // environment variables to inherit from host, as "key"
Logger *log.Logger // optional log for errors or nil to use log.Print
Args []string
// PathLocationHandler specifies the root http Handler that
// should handle internal redirects when the CGI process
// returns a Location header value starting with a "/", as
// specified in RFC 3875 6.3.2. This will likely be
// http.DefaultServeMux.
//
// If nil, a CGI response with a local URI path is instead sent
// back to the client and not redirected internally.
PathLocationHandler http.Handler
}
Handler runs an executable in a subprocess with a CGI environment.
func (h *Handler) ServeHTTP(rw http.ResponseWriter, req *http.Request)