php example, some doc

Author: Michael Lauer

README.md

@@ -0,0 +1,22 @@
+gofcgisrv
+=========
+
+Go package for the webserver end of the
+[CGI](http://tools.ietf.org/html/rfc3875), 
+[FastCGI](http://www.fastcgi.com/drupal/node/6?q=node/22), 
+and [SCGI](http://python.ca/scgi/protocol.txt) protocols.
+
+The terms "server" and "client" are confusing. "Server" here generally means "webserver," as referred to in
+(for example) the FastCGI spec. In terms of who is dialing whom, the webserver is the FastCGI or SCGI client.
+Sorry.
+
+See godoc for usage.
+
+No one really seems to support FastCGI properly and completely.
+
+Bugs and todos
+--------------
+
+There is nothing here to launch processes. Only TCP connections are supported, not STDIN.
+
+Not all CGI headers are correctly set.

gofcgisrv.go

@@ -1,5 +1,9 @@
 /*
-Package gofcgisrv implements the webserver side of the FastCGI protocol.
+Package gofcgisrv implements the webserver side of the CGI, FastCGI, and SCGI protocols.
+
+CGI: http://tools.ietf.org/html/rfc3875
+FastCGI: http://www.fastcgi.com/drupal/node/6?q=node/22
+SCGI: http://python.ca/scgi/protocol.txt protocols.
 */
 package gofcgisrv
 

php_test.go

@@ -0,0 +1,39 @@
+package gofcgisrv
+
+import (
+	"fmt"
+	"io/ioutil"
+	"net/http"
+	"net/http/httptest"
+	"path"
+	"strings"
+)
+
+func phpCgiHandler(w http.ResponseWriter, r *http.Request) {
+	filepath := path.Join("./testdata/", r.URL.Path)
+	env := []string{
+		"REDIRECT_STATUS=200",
+		"SCRIPT_FILENAME=" + filepath,
+	}
+
+	ServeHTTP(NewCGI("php-cgi"), env, w, r)
+}
+
+func Example_php() {
+	server := httptest.NewServer(http.HandlerFunc(phpCgiHandler))
+	defer server.Close()
+	url := server.URL
+
+	text := "This is a test!"
+	resp, err := http.Post(url+"/echo.php", "text/plain", strings.NewReader(text))
+	if err == nil {
+		fmt.Printf("Status: %v\n", resp.StatusCode)
+		body, _ := ioutil.ReadAll(resp.Body)
+		resp.Body.Close()
+		fmt.Printf("Response: %s\n", body)
+	}
+
+	// Output:
+	// Status: 200
+	// Response: This is a test!
+}

testdata/echo.php

@@ -0,0 +1,4 @@
+<?php
+    $body = file_get_contents('php://input');
+    echo $body;
+?>