CGI

Diese Seite muss überarbeitet werden

Diese Seite wurde als Baustelle gekennzeichnet, weil sie überarbeitet werden muss. Eine Begründung dafür findest du auf der Diskussionsseite. Bitte hilf mit, diese Seite zu verbessern!

Alle Dynamic-Pakete bei Hostsharing erlauben die Ausführung von Skripten auf dem Server. Dabei gibt es mehrere Möglichkeiten, zum einen direkt in den Webserver eingebundene Module wie mod_php für die Skriptsprache PHP, zum anderen die Ausführung über CGI (Common Gateway Interface). Letzteres ist keine eigene Skriptsprache, sondern nur eine Schnittstelle, über die Daten an eine Skriptsprache, wie z.B. perl oder php übergeben werden können. Solche Daten könnten z.B. die abgerufene URL, Zugriff auf Cookies etc. sein. Über die Schnittstelle cgi können Skriptsprachen wie Perl oder auch PHP, aber auch selbst kompilierte Binär-Programme ausgeführt werden.

CGI-Skripte liegen bei Hostsharing in einem Verzeichnisbaum direkt unter der Domain in einem Verzeichnis mit dem Namen cgi, also parallel zu den Verzeichnissen etc, subs und var. Von Seiten der URL werden sie als /cgi-bin eingeblendet. Ein Script, das unter ~/doms/example.com/cgi/ liegt, wird also über http://www.example.com/cgi-bin/ angesprochen.

Ein kleines Beispiel soll uns zeigen, was CGI eigentlich leistet. Dazu erstellen wir die Datei settings.cgi in unserem cgi-Verzeichnis mit folgendem Inhalt:

 #!/bin/sh
 echo Content-type: text/plain
 echo
 set 

Nach dem Abspeichern müssen wir die Datei noch als ausführbar markieren (dies muss beides mit dem Domain-Admin-Account gemacht werden, da nur der an das cgi-Verzeichnis herankommt):

 xyz00-hans@hopi$ chmod +x ~/doms/example.com/cgi/settings.cgi

Dieses kleine Skript macht nichts weiter, als in einem HTTP-Header dem Browser mitzuteilen, dass es sich um einfachen Text handelt und ihn dann zu veranlassen, die gesamten Parameter auszugeben, die über die CGI-Schnittstelle als Umgebungsvariable mitgegeben wurden.

Ein Aufruf der URL http://www.example.com/cgi-bin/settings.cgi erzeugt also in etwa folgende Ausgabe:

 HOSTNAME=hopi
 HOSTTYPE=i386
 HTTP_ACCEPT='text/html, image/png, image/jpeg, image/gif, image/x-xbitmap, */*'
 HTTP_ACCEPT_CHARSET='windows-1252;q=1.0, utf-8;q=1.0, utf-16;q=1.0, iso-8859-1;q=0.6, *;q=0.1'
 HTTP_ACCEPT_ENCODING='deflate, gzip, x-gzip, identity, *;q=0'
 HTTP_CGI_AUTHORIZATION=
 HTTP_CONNECTION='Keep-Alive, TE'
 HTTP_HOST=www.deineigenerdomainname.de
 HTTP_TE='deflate, gzip, chunked, identity, trailers'
 HTTP_USER_AGENT='Opera/6.0 (Linux 2.4.17 i686; U)  [en]'
 ...
 QUERY_STRING=
 REMOTE_ADDR=62.156.160.59
 REMOTE_PORT=36344
 REQUEST_METHOD=GET
 REQUEST_URI=/cgi-bin/test.cgi
 SCRIPT_FILENAME=/home/doms/dynamic-webspace.de/cgi/test.cgi
 SCRIPT_NAME=/cgi-bin/test.cgi
 SCRIPT_URI=http://www.dynamic-webspace.de/cgi-bin/test.cgi
 SCRIPT_URL=/cgi-bin/test.cgi
 SERVER_ADDR=66.70.34.151
 SERVER_ADMIN=mih01@hopi.hostsharing.net
 SERVER_NAME=www.dynamic-webspace.de
 SERVER_PORT=80
 SERVER_PROTOCOL=HTTP/1.1
 SERVER_SOFTWARE='Apache/1.3.23 (Unix) Debian GNU/Linux mod_xslt/Xalan/1.0 mod_gzip/1.3.19.1a PHP/4.1.2 mod_auth_pam/1.0a mod_perl/1.26'

Achtung

Eine typische Falle ist das Hochladen von Dateien mit MS-DOS Zeilenumbrüchen (CR/LF) statt UNIX Zeilenumbrüchen (LF). Da die erste Zeile in einem solchen Skript (hier #!/bin/sh) das Programm angibt, mit dem das Skript ausgeführt wird, wird schon das fehlschlagen, da sich am Ende der Zeile ein unsichtbares CR befinden wird. Der HTTP Fehler 500 (Internal Server Error) wird erscheinen. FTP bietet zu dem Zweck den ASCII-Mode an, der die Transformation zwischen den Systemen vornimmt. Binäre Dateien (z.B. Grafiken) sollten niemals, Skripte dagegen immer im ASCII-Modus übertragen werden.