README
¶
Go fastcgi client with fcgi params support
Examples
simple get request
func main() {
reqParams := "name=value"
env := make(map[string]string)
env["SCRIPT_FILENAME"] = "/home/www/test.php"
env["SERVER_SOFTWARE"] = "go / fcgiclient "
env["REMOTE_ADDR"] = "127.0.0.1"
env["QUERY_STRING"] = reqParams
fcgi, err := fcgiclient.Dial("unix", "/tmp/php-fpm.sock")
if err != nil {
log.Println("err:", err)
}
resp, err := fcgi.Get(env)
if err != nil {
log.Println("err:", err)
}
content, err = ioutil.ReadAll(resp.Body)
if err != nil {
log.Println("err:", err)
}
log.Println("content:", string(content))
}
or post form data
func main() {
env := make(map[string]string)
env["SCRIPT_FILENAME"] = "/home/www/test.php"
fcgi, err := fcgiclient.Dial("unix", "/tmp/php-fpm.sock")
if err != nil {
log.Println("err:", err)
}
resp, err := fcgi.PostForm(env, url.Values{"foo": {"bar"}})
if err != nil {
log.Println("err:", err)
}
content, err = ioutil.ReadAll(resp.Body)
if err != nil {
log.Println("err:", err)
}
log.Println("content:", string(content))
}
or send file
func main() {
env := make(map[string]string)
env["SCRIPT_FILENAME"] = "/home/www/test.php"
fcgi, err := fcgiclient.Dial("unix", "/tmp/php-fpm.sock")
if err != nil {
log.Println("err:", err)
}
resp, err := fcgi.PostFile(env, url.Values{"foo": {"bar"}}, map[string]string{"file1":"/path/to/file1"})
if err != nil {
log.Println("err:", err)
}
content, err = ioutil.ReadAll(resp.Body)
if err != nil {
log.Println("err:", err)
}
log.Println("content:", string(content))
}
More examples can be found in fcgiclient_test.go
Functions
func Dial
func Dial(network, address string) (fcgi *FCGIClient, err error)
Connects to the fcgi responder at the specified network address. See func net.Dial for a description of the network and address parameters.
func DialTimeout
func DialTimeout(network, address string, timeout time.Duration) (fcgi *FCGIClient, err error)
Connects to the fcgi responder at the specified network address with timeout. See func net.DialTimeout for a description of the network, address and timeout parameters.
func (*FCGIClient) Get
func (this *FCGIClient) Get(p map[string]string) (resp *http.Response, err error)
Get issues a GET request to the fcgi responder.
func (*FCGIClient) Post
func (this *FCGIClient) Post(p map[string]string, bodyType string,
body io.Reader, l int) (resp *http.Response, err error)
Get issues a Post request to the fcgi responder. with request body in the format that bodyType specified
func (*FCGIClient) PostFile
func (this *FCGIClient) PostFile(p map[string]string, data url.Values,
file map[string]string) (resp *http.Response, err error)
PostFile issues a POST to the fcgi responder in multipart(RFC 2046) standard, with form as a string key to a list values (url.Values), and/or with file as a string key to a list file path.
func (*FCGIClient) PostForm
func (this *FCGIClient) PostForm(p map[string]string,
data url.Values) (resp *http.Response, err error)
PostForm issues a POST to the fcgi responder, with form as a string key to a list values (url.Values)
func (*FCGIClient) Request
func (this *FCGIClient) Do(p map[string]string, req io.Reader) (r io.Reader, err error)
Request returns a HTTP Response with Header and Body from fcgi responder
func (*FCGIClient) Do
func (this *FCGIClient) Request(p map[string]string,
req io.Reader) (resp *http.Response, err error)
Do made the request and returns a io.Reader that translates the data read from fcgi responder out of fcgi packet before returning it.
func (*FCGIClient) Close
func (this *FCGIClient) Close()
Close fcgi connnection
Documentation
¶
Index ¶
- Constants
- type FCGIClient
- func (this *FCGIClient) Close()
- func (this *FCGIClient) Do(p map[string]string, req io.Reader) (r io.Reader, err error)
- func (this *FCGIClient) Get(p map[string]string) (resp *http.Response, err error)
- func (this *FCGIClient) Post(p map[string]string, bodyType string, body io.Reader, l int) (resp *http.Response, err error)
- func (this *FCGIClient) PostFile(p map[string]string, data url.Values, file map[string]string) (resp *http.Response, err error)
- func (this *FCGIClient) PostForm(p map[string]string, data url.Values) (resp *http.Response, err error)
- func (this *FCGIClient) Request(p map[string]string, req io.Reader) (resp *http.Response, err error)
Constants ¶
const ( FCGI_BEGIN_REQUEST uint8 = iota + 1 FCGI_ABORT_REQUEST FCGI_END_REQUEST FCGI_PARAMS FCGI_STDIN FCGI_STDOUT FCGI_STDERR FCGI_DATA FCGI_GET_VALUES FCGI_GET_VALUES_RESULT FCGI_UNKNOWN_TYPE FCGI_MAXTYPE = FCGI_UNKNOWN_TYPE )
const ( FCGI_RESPONDER uint8 = iota + 1 FCGI_AUTHORIZER FCGI_FILTER )
const ( FCGI_REQUEST_COMPLETE uint8 = iota FCGI_CANT_MPX_CONN FCGI_OVERLOADED FCGI_UNKNOWN_ROLE )
const ( FCGI_MAX_CONNS string = "MAX_CONNS" FCGI_MAX_REQS string = "MAX_REQS" FCGI_MPXS_CONNS string = "MPXS_CONNS" )
const FCGI_HEADER_LEN uint8 = 8
const FCGI_KEEP_CONN uint8 = 1
const FCGI_LISTENSOCK_FILENO uint8 = 0
const FCGI_NULL_REQUEST_ID uint8 = 0
const VERSION_1 uint8 = 1
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type FCGIClient ¶
type FCGIClient struct {
// contains filtered or unexported fields
}
func Dial ¶
func Dial(network, address string) (fcgi *FCGIClient, err error)
Connects to the fcgi responder at the specified network address. See func net.Dial for a description of the network and address parameters.
func DialTimeout ¶
func DialTimeout(network, address string, timeout time.Duration) (fcgi *FCGIClient, err error)
Connects to the fcgi responder at the specified network address with timeout See func net.DialTimeout for a description of the network, address and timeout parameters.
func (*FCGIClient) Do ¶
Do made the request and returns a io.Reader that translates the data read from fcgi responder out of fcgi packet before returning it.
func (*FCGIClient) Post ¶
func (this *FCGIClient) Post(p map[string]string, bodyType string, body io.Reader, l int) (resp *http.Response, err error)
Get issues a Post request to the fcgi responder. with request body in the format that bodyType specified
func (*FCGIClient) PostFile ¶
func (this *FCGIClient) PostFile(p map[string]string, data url.Values, file map[string]string) (resp *http.Response, err error)
PostFile issues a POST to the fcgi responder in multipart(RFC 2046) standard, with form as a string key to a list values (url.Values), and/or with file as a string key to a list file path.
Source Files