Simple Common Gateway Interface
||This article may require cleanup to meet Wikipedia's quality standards. (August 2008)|
The Simple Common Gateway Interface (SCGI) is a protocol for applications to interface with HTTP servers, as an alternative to the CGI protocol. It is similar to FastCGI but is designed to be easier to implement and crucially, unlike FastCGI, practically permits CGI operations where the CGI operation has significant latency[clarification needed] (e.g. contacting an external database).
The specification document was placed in the public domain by Neil Schemenauer on 12 January 2006.
The client connects to a SCGI server over a reliable stream protocol allowing transmission of 8-bit bytes. The client begins by sending a request. See below for the format of the request. When the SCGI server sees the end of the request it sends back a response and closes the connection. The format of the response is not specified by this protocol.
A request consists of a number of headers and a body. The format of the headers is:
headers ::= header* header ::= name NUL value NUL name ::= notnull+ value ::= notnull* notnull ::= <01> | <02> | <03> | … | <ff> NUL = <00>
Duplicate names are not allowed in the headers. The first header must have the name "CONTENT_LENGTH" and a value that is the length of the body in decimal. The "CONTENT_LENGTH" header must always be present, even if its value is "0". There must also always be a header with the name "SCGI" and a value of "1". In order to facilitate the transition from CGI, standard CGI environment variables should be provided as SCGI headers.
The headers are sent to the server application encoded as a netstring. The body is sent following the headers and its length is specified by the "CONTENT_LENGTH" header.
The web server (an SCGI client) opens a connection and sends the concatenation of the following strings:
"70:" "CONTENT_LENGTH" <00> "56" <00> "SCGI" <00> "1" <00> "REQUEST_METHOD" <00> "POST" <00> "REQUEST_URI" <00> "/deepthought" <00> "," "What is the answer to life, the Universe and everything?"
The web application (SCGI server) sends the following response:
"Status: 200 OK" <0d 0a> "Content-Type: text/plain" <0d 0a> "" <0d 0a> "42"
The SCGI server then closes the connection.
Web servers that implement SCGI
|This section requires expansion. (August 2008)|
- Apache HTTP Server
- Mathopd - with unofficial patch
- Microsoft Internet Information Services with ISAPI SCGI extension
Language bindings for the SCGI API
|This section requires expansion. (October 2008)|
- Rack - Ruby web server interface
- PSGI - Perl Web Server Gateway Interface
- WSGI - Web Server Gateway Interface
- SCGI specification
- Ether - Ada SCGI library
- Original Ada SCGI interface
- netstrings specification
- Apache SCGI modules and Python SCGI interface
- Cherokee SCGI module
- Cherokee's Python SCGI module
- Perl SCGI interface
- Java SCGI connector
- Haskell SCGI package
- Nginx SCGI Module
- Tcl SCGI module
- IIS SCGI extension