„Simple Common Gateway Interface“ – Versionsunterschied

Versionsgeschichte interaktiv durchsuchen

[gesichtete Version]

Inhalt gelöscht Inhalt hinzugefügt

Inline

Aktuelle Version vom 17. Mai 2025, 02:38 Uhr

Das Simple Common Gateway Interface (SCGI) ist ein textbasiertes Netzwerkprotokoll für die Anbindung eines Anwendungsservers an einen Webserver. Es ist eine Alternative zu HTTP und dem klassischen CGI und ähnelt dem FastCGI-Protokoll.

Die Spezifikation wurde von Neil Schemenauer erstellt und am 12. Januar 2006 als gemeinfreie Spezifikation veröffentlicht. Im Vergleich zu FastCGI ist das SCGI-Protokoll einfacher zu implementieren; moderne Webserver bieten mittlerweile gleichermaßen Unterstützung für FastCGI und SCGI an.

Protokollbeschreibung

Jeder SCGI-Request (engl. Anfrage) besteht aus einer Liste von Headern (Beschreibung des Inhalts) und einem Body (Inhalt). Die Header werden als Netstring kodiert und anschließend gefolgt vom Body über eine eigene Verbindung zur SCGI-Anwendung verschickt. Die Verbindung bleibt dabei bestehen und wird erst, nachdem die SCGI-Anwendung eine Antwort geschickt hat, beendet.

Durch die Kodierung der Header als Netstring beginnt jeder SCGI-Request mit einer Ziffer. Da dieser deshalb mit einem ASCII Byte zwischen '1' und '9' beginnt, kann dieser von einem HTTP-Forward unterschieden werden – eine laufende SCGI-Applikation kann so leicht in die Lage versetzt werden, gleichermaßen SCGI-Requests und HTTP GET/POST-Anfragen zu behandeln.

Für die Antwort ist im Protokoll kein Format definiert.^[1] Es ist allerdings wie bei CGI üblich, dass die Antwort mit dem Status-Parameter beginnt.

<Key>	<NUL>	<Value>	<NUL>

Wie oben dargestellt besteht jeder Header aus einem Key-Value-Pair (engl. Schlüssel-Wert-Paar). Dabei wird der Schlüssel mit einem ASCII-Null (NUL) vom Wert getrennt, sowie der Header mit einem ASCII-Null (NUL) abgeschlossen. Jeder Schlüssel muss eindeutig sein und darf folglich nur einmal vorkommen.

SCGI-Request

<Länge des Netstrings>:	"CONTENT_LENGTH"	<NUL>	<Länge des Body>	<NUL>	"SCGI"	<NUL>	1	<NUL>	...	","	<Body>

Der erste Header muss den Schlüssel "CONTENT_LENGTH" haben und darf keinen leeren Wert haben, selbst wenn die Länge des Body 0 beträgt. Danach folgen alle übrigen Header, die aber optional sind mit Ausnahme eines mit Schlüssel "SCGI" und Wert 1.

Webserverunterstützung

Folgende Webserver unterstützen das SCGI-Protokoll.

Sprachanbindung

Folgende Programmiersprachen unterstützen die Erstellung von SCGI-Applikationen per Sprachanbindung:

Einzelnachweise

↑ SCGI-Spezifikation, § 2
↑ Althttpd: The Althttpd Webserver. Abgerufen am 19. Mai 2023.

Weblinks

[1] SCGI-Spezifikation, § 2

[2] Althttpd: The Althttpd Webserver. Abgerufen am 19. Mai 2023.

[1]

[2]

@@ Zeile 1: / Zeile 1: @@
-Das '''Simple Common Gateway Interface''' ('''SCGI''') ist ein Standard für den Datenaustausch zwischen einem [[Webserver]] und dritter Software, die Anfragen bearbeitet. Es ist eine Alternative zu klassischem [[Common Gateway Interface|CGI]] und ähnelt dem [[FastCGI]] Protokoll.
+Das '''Simple Common Gateway Interface''' ('''SCGI''') ist ein textbasiertes [[Netzwerkprotokoll]] für die Anbindung eines [[Anwendungsserver]]s an einen [[Webserver]]. Es ist eine Alternative zu [[Hypertext Transfer Protocol|HTTP]] und dem klassischen [[Common Gateway Interface|CGI]] und ähnelt dem [[FastCGI]]-Protokoll.
-Die Spezifikation wurde von Neil Schemenauer <nas@python.ca> erstellt und am 12. Januar 2006 als gemeinfreie Spezifikation veröffentlicht. Im Vergleich mit FastCGI ist das SCGI Protokoll einfacher zu implementieren; die modernen Webserver bieten mittlerweile gleichermaßen Unterstützung für das FastCGI und das SCGI Protokoll.
+Die Spezifikation wurde von Neil Schemenauer erstellt und am 12. Januar 2006 als gemeinfreie Spezifikation veröffentlicht. Im Vergleich zu FastCGI ist das SCGI-Protokoll einfacher zu implementieren; moderne Webserver bieten mittlerweile gleichermaßen Unterstützung für FastCGI und SCGI an.
 == Protokollbeschreibung ==
+Jeder SCGI-Request ([[Englische Sprache|engl.]] Anfrage) besteht aus einer Liste von Headern (Beschreibung des Inhalts) und einem Body (Inhalt). Die Header werden als Netstring kodiert und anschließend gefolgt vom Body über eine eigene Verbindung zur SCGI-Anwendung verschickt. Die Verbindung bleibt dabei bestehen und wird erst, nachdem die SCGI-Anwendung eine Antwort geschickt hat, beendet.
-Der Webserver öffnet für jeden Request eine eigene Verbindung zur SCGI-Applikation und beginnt mit dem Versenden eines Parameterblocks. Der Parameterblock ist als Netstring kodiert (Netstrings beginnen mit einer Ascii-dezimalen Längenangabe, gefolgt von einem Ascii-dezimalen Doppelpunkt, der eigentlichen Payload mit beliebigen Bytes und einem Ascii-Komma als Prüf-Anhang). Im Parameterblock werden Paare aus Name und Wert, jeweils mit <00>-Nullbyte getrennt, gesendet die den Umgebungsvariablen des CGI-Protokolls entsprechen. In der Parameterliste sollte ein Parameter SCGI mit Wert 1 auftreten und es muss ein Parameter CONTENT_LENGTH auftreten, der die Länge der Daten nach dem Parameterblock beschreibt.
+Durch die Kodierung der Header als Netstring beginnt jeder SCGI-Request mit einer Ziffer. Da dieser deshalb mit einem ASCII Byte zwischen '1' und '9' beginnt, kann dieser von einem HTTP-Forward unterschieden werden – eine laufende SCGI-Applikation kann so leicht in die Lage versetzt werden, gleichermaßen SCGI-Requests und HTTP GET/POST-Anfragen zu behandeln.
-Nach Dekodieren des Request sendet die SCGI-Applikation auf der geöffneten Verbindung die Antwort, die wie bei CGI üblich mit dem Status-Feld beginnt. Nach Versenden der CGI-Antwort wird die Verbindung von der SCGI-Applikation beendet.
+Für die Antwort ist im Protokoll kein Format definiert.<ref>[http://python.ca/scgi/protocol.txt SCGI-Spezifikation, § 2]</ref> Es ist allerdings wie bei CGI üblich, dass die Antwort mit dem Status-Parameter beginnt.
-Da eine SCGI-Verbindung mit einem ASCII '1' bis '9' Byte beginnt, kann ein SCGI-kodierter Request von einem HTTP-Forward unterschieden werden - eine laufende CGI Applikation kann so leicht in die Lage versetzt werden, gleichermaßen SCGI Requests und HTTP GET/POST Requests zu behandeln.
+=== Header ===
-== Webserver Unterstützung ==
+{| class="wikitable"
-Folgende Webserver unterstützen das SCGI-Protokoll
+|-
+| <Key> || <NUL> || <Value> || <NUL>
+|}
+Wie oben dargestellt besteht jeder Header aus einem Key-Value-Pair ([[Englische Sprache|engl.]] Schlüssel-Wert-Paar). Dabei wird der Schlüssel mit einem ASCII-Null (NUL) vom Wert getrennt, sowie der Header mit einem ASCII-Null (NUL) abgeschlossen. Jeder Schlüssel muss eindeutig sein und darf folglich nur einmal vorkommen.
+=== SCGI-Request ===
+{| class="wikitable"
+|-
+| <Länge des Netstrings>: || "CONTENT_LENGTH" || <NUL> || <Länge des Body> || <NUL> || "SCGI" || <NUL> || 1 || <NUL> || ... || "," ||<Body>
+|}
+Der erste Header muss den Schlüssel "CONTENT_LENGTH" haben und darf keinen leeren Wert haben, selbst wenn die Länge des Body 0 beträgt. Danach folgen alle übrigen Header, die aber optional sind mit Ausnahme eines mit Schlüssel "SCGI" und Wert 1.
+== Webserverunterstützung ==
+Folgende Webserver unterstützen das SCGI-Protokoll.
 * [[Apache HTTP Server]]
 * [[Lighttpd]]
-* [[Cherokee HTTP Server]]
 * [[Nginx|Nginx Server]]
+* Althttpd<ref>{{Internetquelle |url=https://sqlite.org/althttpd/doc/trunk/althttpd.md |titel=Althttpd: The Althttpd Webserver |abruf=2023-05-19}}</ref>
 == Sprachanbindung ==
-Folgende Programmiersprachen unterstützen die Erstellung von SCGI-Applikationen.
+Folgende Programmiersprachen unterstützen die Erstellung von SCGI-Applikationen per [[Sprachanbindung]]:
-* [[Ruby_(Programmiersprache)|Ruby]]
+* [[D (Programmiersprache)|D]]
+* [[Ruby (Programmiersprache)|Ruby]]
 * [[Python (Programmiersprache)|Python]]
-* [[Lisp|Lisp]]
+* [[Lisp]]
-* [[Perl]]
+* [[Perl (Programmiersprache)|Perl]]
-* [[Haskell]]
+* [[Haskell (Programmiersprache)|Haskell]]
 * [[Java (Programmiersprache)|Java]]
 * [[PHP]]
+* [[Tcl]]
+== Einzelnachweise ==
+<references />
 == Weblinks ==
-* [http://python.ca/scgi/protocol.txt SCGI specification]
+* [http://python.ca/scgi/protocol.txt SCGI-Spezifikation]
-* [http://cr.yp.to/proto/netstrings.txt netstrings specification]
+* [http://cr.yp.to/proto/netstrings.txt Netstrings-Spezifikation]
-* [http://python.ca/scgi/ Apache SCGI modules and Python SCGI interface]
+* [http://python.ca/scgi/ Apache SCGI-Module und Python SCGI-Interface]
-* [http://www.cherokee-project.com/bugs/browser/cherokee/trunk/cherokee/handler_scgi.c Cherokee SCGI module]
+* [http://www.cherokee-project.com/bugs/browser/cherokee/trunk/cherokee/handler_scgi.c Cherokee SCGI-Modul]
-* [http://search.cpan.org/~vipercode/SCGI/lib/SCGI.pm Perl SCGI interface]
+* [http://metacpan.org/module/SCGI Perl SCGI-Interface]
-* [http://snippets.dzone.com/posts/show/4304 Java SCGI connector]
+* [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/scgi Haskell SCGI Package]
-* [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/scgi Haskell SCGI package]
 * [http://code.google.com/p/appserver-in-php/ PHP SCGI Libraries]
-* [http://wiki.codemongers.com/NginxNgxSCGIModule Nginx SCGI Module]
+* [http://wiki.codemongers.com/NginxNgxSCGIModule Nginx SCGI-Modul]
+* [http://woof.sourceforge.net/woof-ug/_woof/docs/ug/start_scgi WOOF! Framework]
+{{Navigationsleiste Webserver-Schnittstellen}}
-[[en:Simple Common Gateway Interface]]
-[[es:SCGI]]
-[[fr:Simple Common Gateway Interface]]
-[[ru:SCGI]]
-[[Kategorie:World Wide Web]]
+[[Kategorie:Webserver]]
+[[Kategorie:Netzwerkprotokoll auf Anwendungsschicht]]

Protokolle	CGI \| SCGI \| FastCGI \| AJP
APIs	C NSAPI \| C ASAPI \| C ISAPI \| Jakarta Servlet \| ASP.NET \| Python WSGI \| Ruby Rack \| JavaScript JSGI \| PSGI \| Lua WSAPI
Apache-Module	mod_jk \| mod_lisp \| mod_parrot \| mod_perl \| mod_php \| mod_python \| mod_wsgi \| mod_ruby \| Phusion Passenger
Web APIs	WSDL \| XML-RPC \| SOAP \| REST