github.com/hxx258456/ccgo@v0.0.5-0.20230213014102-48b35f46f66f/gmhttp/cgi/host.go (about) 1 // Copyright 2011 The Go Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style 3 // license that can be found in the LICENSE file. 4 5 // This file implements the host side of CGI (being the webserver 6 // parent process). 7 8 // Package cgi implements CGI (Common Gateway Interface) as specified 9 // in RFC 3875. 10 // 11 // Note that using CGI means starting a new process to handle each 12 // request, which is typically less efficient than using a 13 // long-running server. This package is intended primarily for 14 // compatibility with existing systems. 15 package cgi 16 17 import ( 18 "bufio" 19 "fmt" 20 "io" 21 "log" 22 "net" 23 "net/textproto" 24 "os" 25 "os/exec" 26 "path/filepath" 27 "regexp" 28 "runtime" 29 "strconv" 30 "strings" 31 32 http "github.com/hxx258456/ccgo/gmhttp" 33 34 "golang.org/x/net/http/httpguts" 35 ) 36 37 var trailingPort = regexp.MustCompile(`:([0-9]+)$`) 38 39 var osDefaultInheritEnv = func() []string { 40 switch runtime.GOOS { 41 case "darwin", "ios": 42 return []string{"DYLD_LIBRARY_PATH"} 43 case "linux", "freebsd", "netbsd", "openbsd": 44 return []string{"LD_LIBRARY_PATH"} 45 case "hpux": 46 return []string{"LD_LIBRARY_PATH", "SHLIB_PATH"} 47 case "irix": 48 return []string{"LD_LIBRARY_PATH", "LD_LIBRARYN32_PATH", "LD_LIBRARY64_PATH"} 49 case "illumos", "solaris": 50 return []string{"LD_LIBRARY_PATH", "LD_LIBRARY_PATH_32", "LD_LIBRARY_PATH_64"} 51 case "windows": 52 return []string{"SystemRoot", "COMSPEC", "PATHEXT", "WINDIR"} 53 } 54 return nil 55 }() 56 57 // Handler runs an executable in a subprocess with a CGI environment. 58 type Handler struct { 59 Path string // path to the CGI executable 60 Root string // root URI prefix of handler or empty for "/" 61 62 // Dir specifies the CGI executable's working directory. 63 // If Dir is empty, the base directory of Path is used. 64 // If Path has no base directory, the current working 65 // directory is used. 66 Dir string 67 68 Env []string // extra environment variables to set, if any, as "key=value" 69 InheritEnv []string // environment variables to inherit from host, as "key" 70 Logger *log.Logger // optional log for errors or nil to use log.Print 71 Args []string // optional arguments to pass to child process 72 Stderr io.Writer // optional stderr for the child process; nil means os.Stderr 73 74 // PathLocationHandler specifies the root http Handler that 75 // should handle internal redirects when the CGI process 76 // returns a Location header value starting with a "/", as 77 // specified in RFC 3875 ยง 6.3.2. This will likely be 78 // http.DefaultServeMux. 79 // 80 // If nil, a CGI response with a local URI path is instead sent 81 // back to the client and not redirected internally. 82 PathLocationHandler http.Handler 83 } 84 85 func (h *Handler) stderr() io.Writer { 86 if h.Stderr != nil { 87 return h.Stderr 88 } 89 return os.Stderr 90 } 91 92 // removeLeadingDuplicates remove leading duplicate in environments. 93 // It's possible to override environment like following. 94 // cgi.Handler{ 95 // ... 96 // Env: []string{"SCRIPT_FILENAME=foo.php"}, 97 // } 98 func removeLeadingDuplicates(env []string) (ret []string) { 99 for i, e := range env { 100 found := false 101 if eq := strings.IndexByte(e, '='); eq != -1 { 102 keq := e[:eq+1] // "key=" 103 for _, e2 := range env[i+1:] { 104 if strings.HasPrefix(e2, keq) { 105 found = true 106 break 107 } 108 } 109 } 110 if !found { 111 ret = append(ret, e) 112 } 113 } 114 return 115 } 116 117 func (h *Handler) ServeHTTP(rw http.ResponseWriter, req *http.Request) { 118 root := h.Root 119 if root == "" { 120 root = "/" 121 } 122 123 if len(req.TransferEncoding) > 0 && req.TransferEncoding[0] == "chunked" { 124 rw.WriteHeader(http.StatusBadRequest) 125 rw.Write([]byte("Chunked request bodies are not supported by CGI.")) 126 return 127 } 128 129 pathInfo := req.URL.Path 130 if root != "/" && strings.HasPrefix(pathInfo, root) { 131 pathInfo = pathInfo[len(root):] 132 } 133 134 port := "80" 135 if matches := trailingPort.FindStringSubmatch(req.Host); len(matches) != 0 { 136 port = matches[1] 137 } 138 139 env := []string{ 140 "SERVER_SOFTWARE=go", 141 "SERVER_NAME=" + req.Host, 142 "SERVER_PROTOCOL=HTTP/1.1", 143 "HTTP_HOST=" + req.Host, 144 "GATEWAY_INTERFACE=CGI/1.1", 145 "REQUEST_METHOD=" + req.Method, 146 "QUERY_STRING=" + req.URL.RawQuery, 147 "REQUEST_URI=" + req.URL.RequestURI(), 148 "PATH_INFO=" + pathInfo, 149 "SCRIPT_NAME=" + root, 150 "SCRIPT_FILENAME=" + h.Path, 151 "SERVER_PORT=" + port, 152 } 153 154 if remoteIP, remotePort, err := net.SplitHostPort(req.RemoteAddr); err == nil { 155 env = append(env, "REMOTE_ADDR="+remoteIP, "REMOTE_HOST="+remoteIP, "REMOTE_PORT="+remotePort) 156 } else { 157 // could not parse ip:port, let's use whole RemoteAddr and leave REMOTE_PORT undefined 158 env = append(env, "REMOTE_ADDR="+req.RemoteAddr, "REMOTE_HOST="+req.RemoteAddr) 159 } 160 161 if req.TLS != nil { 162 env = append(env, "HTTPS=on") 163 } 164 165 for k, v := range req.Header { 166 k = strings.Map(upperCaseAndUnderscore, k) 167 if k == "PROXY" { 168 // See Issue 16405 169 continue 170 } 171 joinStr := ", " 172 if k == "COOKIE" { 173 joinStr = "; " 174 } 175 env = append(env, "HTTP_"+k+"="+strings.Join(v, joinStr)) 176 } 177 178 if req.ContentLength > 0 { 179 env = append(env, fmt.Sprintf("CONTENT_LENGTH=%d", req.ContentLength)) 180 } 181 if ctype := req.Header.Get("Content-Type"); ctype != "" { 182 env = append(env, "CONTENT_TYPE="+ctype) 183 } 184 185 envPath := os.Getenv("PATH") 186 if envPath == "" { 187 envPath = "/bin:/usr/bin:/usr/ucb:/usr/bsd:/usr/local/bin" 188 } 189 env = append(env, "PATH="+envPath) 190 191 for _, e := range h.InheritEnv { 192 if v := os.Getenv(e); v != "" { 193 env = append(env, e+"="+v) 194 } 195 } 196 197 for _, e := range osDefaultInheritEnv { 198 if v := os.Getenv(e); v != "" { 199 env = append(env, e+"="+v) 200 } 201 } 202 203 if h.Env != nil { 204 env = append(env, h.Env...) 205 } 206 207 env = removeLeadingDuplicates(env) 208 209 var cwd, path string 210 if h.Dir != "" { 211 path = h.Path 212 cwd = h.Dir 213 } else { 214 cwd, path = filepath.Split(h.Path) 215 } 216 if cwd == "" { 217 cwd = "." 218 } 219 220 internalError := func(err error) { 221 rw.WriteHeader(http.StatusInternalServerError) 222 h.printf("CGI error: %v", err) 223 } 224 225 cmd := &exec.Cmd{ 226 Path: path, 227 Args: append([]string{h.Path}, h.Args...), 228 Dir: cwd, 229 Env: env, 230 Stderr: h.stderr(), 231 } 232 if req.ContentLength != 0 { 233 cmd.Stdin = req.Body 234 } 235 stdoutRead, err := cmd.StdoutPipe() 236 if err != nil { 237 internalError(err) 238 return 239 } 240 241 err = cmd.Start() 242 if err != nil { 243 internalError(err) 244 return 245 } 246 if hook := testHookStartProcess; hook != nil { 247 hook(cmd.Process) 248 } 249 defer cmd.Wait() 250 defer stdoutRead.Close() 251 252 linebody := bufio.NewReaderSize(stdoutRead, 1024) 253 headers := make(http.Header) 254 statusCode := 0 255 headerLines := 0 256 sawBlankLine := false 257 for { 258 line, isPrefix, err := linebody.ReadLine() 259 if isPrefix { 260 rw.WriteHeader(http.StatusInternalServerError) 261 h.printf("cgi: long header line from subprocess.") 262 return 263 } 264 if err == io.EOF { 265 break 266 } 267 if err != nil { 268 rw.WriteHeader(http.StatusInternalServerError) 269 h.printf("cgi: error reading headers: %v", err) 270 return 271 } 272 if len(line) == 0 { 273 sawBlankLine = true 274 break 275 } 276 headerLines++ 277 parts := strings.SplitN(string(line), ":", 2) 278 if len(parts) < 2 { 279 h.printf("cgi: bogus header line: %s", string(line)) 280 continue 281 } 282 header, val := parts[0], parts[1] 283 if !httpguts.ValidHeaderFieldName(header) { 284 h.printf("cgi: invalid header name: %q", header) 285 continue 286 } 287 val = textproto.TrimString(val) 288 switch { 289 case header == "Status": 290 if len(val) < 3 { 291 h.printf("cgi: bogus status (short): %q", val) 292 return 293 } 294 code, err := strconv.Atoi(val[0:3]) 295 if err != nil { 296 h.printf("cgi: bogus status: %q", val) 297 h.printf("cgi: line was %q", line) 298 return 299 } 300 statusCode = code 301 default: 302 headers.Add(header, val) 303 } 304 } 305 if headerLines == 0 || !sawBlankLine { 306 rw.WriteHeader(http.StatusInternalServerError) 307 h.printf("cgi: no headers") 308 return 309 } 310 311 if loc := headers.Get("Location"); loc != "" { 312 if strings.HasPrefix(loc, "/") && h.PathLocationHandler != nil { 313 h.handleInternalRedirect(rw, req, loc) 314 return 315 } 316 if statusCode == 0 { 317 statusCode = http.StatusFound 318 } 319 } 320 321 if statusCode == 0 && headers.Get("Content-Type") == "" { 322 rw.WriteHeader(http.StatusInternalServerError) 323 h.printf("cgi: missing required Content-Type in headers") 324 return 325 } 326 327 if statusCode == 0 { 328 statusCode = http.StatusOK 329 } 330 331 // Copy headers to rw's headers, after we've decided not to 332 // go into handleInternalRedirect, which won't want its rw 333 // headers to have been touched. 334 for k, vv := range headers { 335 for _, v := range vv { 336 rw.Header().Add(k, v) 337 } 338 } 339 340 rw.WriteHeader(statusCode) 341 342 _, err = io.Copy(rw, linebody) 343 if err != nil { 344 h.printf("cgi: copy error: %v", err) 345 // And kill the child CGI process so we don't hang on 346 // the deferred cmd.Wait above if the error was just 347 // the client (rw) going away. If it was a read error 348 // (because the child died itself), then the extra 349 // kill of an already-dead process is harmless (the PID 350 // won't be reused until the Wait above). 351 cmd.Process.Kill() 352 } 353 } 354 355 func (h *Handler) printf(format string, v ...interface{}) { 356 if h.Logger != nil { 357 h.Logger.Printf(format, v...) 358 } else { 359 log.Printf(format, v...) 360 } 361 } 362 363 func (h *Handler) handleInternalRedirect(rw http.ResponseWriter, req *http.Request, path string) { 364 url, err := req.URL.Parse(path) 365 if err != nil { 366 rw.WriteHeader(http.StatusInternalServerError) 367 h.printf("cgi: error resolving local URI path %q: %v", path, err) 368 return 369 } 370 // TODO: RFC 3875 isn't clear if only GET is supported, but it 371 // suggests so: "Note that any message-body attached to the 372 // request (such as for a POST request) may not be available 373 // to the resource that is the target of the redirect." We 374 // should do some tests against Apache to see how it handles 375 // POST, HEAD, etc. Does the internal redirect get the same 376 // method or just GET? What about incoming headers? 377 // (e.g. Cookies) Which headers, if any, are copied into the 378 // second request? 379 newReq := &http.Request{ 380 Method: "GET", 381 URL: url, 382 Proto: "HTTP/1.1", 383 ProtoMajor: 1, 384 ProtoMinor: 1, 385 Header: make(http.Header), 386 Host: url.Host, 387 RemoteAddr: req.RemoteAddr, 388 TLS: req.TLS, 389 } 390 h.PathLocationHandler.ServeHTTP(rw, newReq) 391 } 392 393 func upperCaseAndUnderscore(r rune) rune { 394 switch { 395 case r >= 'a' && r <= 'z': 396 return r - ('a' - 'A') 397 case r == '-': 398 return '_' 399 case r == '=': 400 // Maybe not part of the CGI 'spec' but would mess up 401 // the environment in any case, as Go represents the 402 // environment as a slice of "key=value" strings. 403 return '_' 404 } 405 // TODO: other transformations in spec or practice? 406 return r 407 } 408 409 var testHookStartProcess func(*os.Process) // nil except for some tests