Common Gateway Interface

The Common Gateway Interface (CGI) is a standard protocol for interfacing external application software with an information server, commonly a web server.

The task of such an information server is to respond to requests (in the case of web servers, requests from client web browsers) by returning output. Each time a request is received, the server analyzes what the request asks for, and returns the appropriate output. The two simplest ways for the server to do this, are the following:

• if the request identifies a file stored on disk, return the contents of that file;
• if the request identifies an executable command and possibly arguments, run the command and return its output

CGI defines a standard way of doing the second. It defines how information about the server and the request is passed to the command in the form of arguments and environment variables, and how the command can pass back extra information about the output (such as the type) in the form of headers.

Contents 1 cgi-bin 2 History 3 Example 4 Implementation 4.1 Header format 5 Drawbacks 5.1 Alternatives 6 References 7 See also 8 External links

cgi-bin

Web servers often have a cgi-bin directory at the base of the directory tree to hold executable files called with CGI.

History

In 1995, the World Wide Web (WWW) was small but booming. WWW software developers and web site developers kept in touch on the www-talk mailing list, so it was there that a standard for calling command line executables was agreed upon. Specifically mentioned in the CGI spec are the following contributors:

• Rob McCool (author of the NCSA HTTPd web server)
• John Franks (author of the GN web server)
• Ari Luotonen (then developer of the CERN httpd web server)
• Tony Sanders (author of the Plexus web server)
• George Phillips (web server maintainer at the University of British Columbia)

Rob McCool drafted the initial specification, and NCSA still hosts it. It was swiftly implemented in all servers.

Example

An example of a CGI program is the one implementing a wiki. The user agent requests the name of an entry; the server will retrieve the source of that entry's page (if one exists), transform it into HTML, and send the result back to the browser or prompt the user to create it. All wiki operations are managed by this one program.

Implementation

From the Web server's point of view, certain locators, e.g. http://www.example.com/wiki.cgi, are defined as corresponding to a program to execute via CGI. When a request for the URL is received, the corresponding program is executed.

Data is passed into the program using environment variables. This is in contrast to typical execution, where Command-line arguments are used. In the case of HTTP PUT or POSTs, the user-submitted data is provided to the program via the standard input^[1].

The program returns the result to the web server in the form of standard output, prefixed by a header and a blank line.

Header format

The header is encoded in the same way as a HTTP header and must include the MIME type of the document returned^[2]. The headers are generally forwarded with the response back to the user, supplemented by the web server.

Drawbacks

This is a low-tech approach. Calling a command generally means the invocation of a newly created process. Starting up the process will usually take up much more time and memory than the actual work of generating the output^{[citation needed]}, especially when the program still needs to be interpreted or compiled. If the program is called often, the workload can quickly overwhelm web servers.

Alternatives

Several approaches can be adopted for remedying this:

• The popular Web servers developed their own extension mechanisms that allows third-party software to run inside the web server itself, e.g. Apache modules, Netscape NSAPI plug-ins, IIS ISAPI plug-ins. While these interfaces didn't reach the same standardization achieved for CGI, they were at least published and at least partly implemented on multiple web servers.
• FastCGI is a CGI script accelerator. It brings execution within the web server while retaining the CGI calling conventions.

The optimal configuration for any web application will obviously depend on application-specific details, amount of traffic, and complexity of the transaction; these tradeoffs need to be analyzed to determine the best implementation for a given task and budget.

References

1. ^ CGI Script input
2. ^ CGI Primer

• Common Gateway Interface: Introduction. Retrieved February 4, 2008.

See also

• FastCGI
• QDecoder
• SCGI
• Application server
• Perl - A programming language for CGI

External links

• The CGI standard at w3.org.
• The CGI/1.1 specification.
• The complete list of CGI variables is at [1].
• The SCGI protocol is a replacement for the Common Gateway Interface (CGI) protocol.
• Ovid's (Perl) CGI tutorial [retrieved via The Internet Archive]

v • d • e Web server interfaces General Common Gateway Interface (CGI) · Simple CGI · FastCGI Technology specific ISAPI · Java Servlet · NSAPI · AJP · Python WSGI Apache modules mod_perl · mod_php · mod_python (mod_wsgi) · mod_ruby · mod_jk

v • d • e Standards of the World Wide Web Consortium Recommendations Canonical XML · CDF · CGI · CSS · DOM · HTML · MathML · OWL · PLS · RDF · RDF Schema · SISR · SMIL · SOAP · SRGS · SSML · SVG · SPARQL · Timed Text · VoiceXML · WSDL · XForms · XHTML · XML · XML Base · XML Events · XML Information Set · XML Schema (W3C) · XML Signature · XPath · XPointer · XQuery · XSL Transformations · XSL-FO · XSL · XLink Notes XHTML+SMIL · XAdES Working Drafts CCXML · CURIE · InkML · XFrames · XFDL · WICD  · XHTML+MathML+SVG · XBL · XProc · HTML 5

---

No comments have been added.

Your name:
City:
Country:	USA UK India Pakistan UAE Saudi Arabia Germany Afghanistan Albania Algeria Andorra Angola Antigua Barbuda Argentina Armenia Australia Austria Azerbaijan Bahamas Bahrain Bangladesh Barbados Belarus Belgium Belize Benin Bhutan Bolivia Bosnia Herzegovina Botswana Brazil Brunei Bulgaria Burkina Faso Burma Burund Cambodia Cameroon Canada Central African Rep Chad Chile China Columbia Comoros Congo Costa Rica Croatia Cuba Cyprus Czech Republic DR Congo Denmark Djiboutil Dominica Dominican Rep Ecuador Egypt El Salvador Eq Guinea Eritrea Estonia Ethiopia Fiji Finland France Gabon Gambia Georgia Germany Ghana Greece Grenada Grenadines Guatemala Guinea Bissau Guinea Guyana Haiti Honduras Hong Kong Hungary Iceland India Indonesia Iran Iraq Ireland Israel Italy Ivory Coast Jamaica Japan Jordan Kazakhstan Kenya Kiribati Kuwait Kyrgyzstan Laos Latvia Lebanon Liberia Libya Liechtenstein Lithuania Luxembourg Macedonia Macau Madagascar Malawi Malaysia Maldives Mali Malta Mauritania Mauritius Mexico Micronesia Moldova Monaco Mongolia Morocco Mozambique Namibia Nauru Nepal Neth Antilles Netherlands New Zealand Nicaragua Niger Nigeria North Korea Norway Oman Pakistan Panama Papua New Guinea Paraguay Peru Philippines Poland Portugal Puerto Rico Qatar Rawanda Romania Russia Sao Tome Saudi Arabia Senegal Serbia Seychelles Sierra Leone Singapore Slovakia Slovenia Solomon Islands Somalia South Korea South Africa Spain Sri Lanka St Kitts_Nevis St Lucia Sudan Suriname Sweden Switzerland Syria Taiwan Tajikistan Tanzania Thailand Togo Tonga Trinidad and Tobago Tunisia Turkey Turkmenistan Tuvala UAE Uganda Ukraine Uruguay Uzbekistan Vanuatu Venezuela Vietnam Western Samoa Yemen Yugoslavia Zaire Zambia Zimbabwe
Your comments:
Security check * (Please enter the number into adjoining box)