Perl-CGI-Programmierung


Was ist CGI

CGI wird derzeit von NCSA gepflegt. NCSA definiert CGI wie folgt:

CGI (Common Gateway Interface), die allgemeine Gateway-Schnittstelle, ist ein Programm, das auf einem Server wie einem HTTP-Server läuft und eine Schnittstelle zu Client-HTML-Seiten bereitstellt.


Web-Browsing

Um besser zu verstehen, wie CGI funktioniert, können wir mit dem Vorgang beginnen, auf einer Webseite auf einen Link oder eine URL zu klicken:

  • 1. Verwenden Sie Ihren Browser, um auf die URL zuzugreifen und eine Verbindung zum HTTP-Webserver herzustellen.
  • 2. Nachdem der Webserver die Anfrage empfangen hat, parst er die URL und prüft, ob die angeforderte Datei auf dem Server existiert. Wenn sie existiert, gibt er den Inhalt der Datei zurück; andernfalls gibt er eine Fehlermeldung zurück.
  • 3. Der Browser empfängt die Informationen vom Server und zeigt die empfangene Datei oder die Fehlermeldung an.

CGI-Programme können Python-Skripte, Perl-Skripte, Shell-Skripte, C- oder C++-Programme usw. sein.


CGI-Architekturdiagramm

cgiarch


Webserver-Unterstützung und -Konfiguration

Bevor Sie mit der CGI-Programmierung beginnen, stellen Sie sicher, dass Ihr Webserver CGI unterstützt und der CGI-Handler konfiguriert ist.

Apache-CGI-Konfiguration:

CGI-Verzeichnis einrichten:

ScriptAlias /cgi-bin/ /var/www/cgi-bin/

Alle von HTTP-Servern ausgeführten CGI-Programme werden in einem vorkonfigurierten Verzeichnis gespeichert. Dieses Verzeichnis wird als CGI-Verzeichnis bezeichnet und heißt konventionsgemäß /var/www/cgi-bin.

CGI-Dateien haben die Erweiterung .cgi. Perl kann auch die Erweiterung .pl verwenden.

Standardmäßig sind Linux-Server mit /var/www als cgi-bin-Verzeichnis für die Ausführung von CGI-Skripten konfiguriert.

Wenn Sie ein anderes Verzeichnis für die Ausführung von CGI-Skripten angeben möchten, können Sie die Konfigurationsdatei httpd.conf wie folgt ändern:

<Directory "/var/www/cgi-bin">
   AllowOverride None
   Options +ExecCGI
   Order allow,deny
   Allow from all
</Directory>

Fügen Sie AddHandler das Suffix .pl hinzu, damit wir auf Perl-Skriptdateien zugreifen können, die mit .pl enden:

AddHandler cgi-script .cgi .pl .py

Erstes CGI-Programm

Im Folgenden erstellen wir eine Datei test.cgi mit dem folgenden Code:

test.cgi-Code

#!/usr/bin/perl print "Content-type:text/html\r\n\r\n"; print '<html>'; print '<head>'; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print '</head>'; print '<body>'; print '<h2>Hallo Welt! </h2>'; print '<p>Dies ist das erste CGI-Programm von Example Tutorial.</p>'; print '</body>'; print '</html>'; 1;

Öffnen Sie dann http://localhost/cgi-bin/test.cgi in einem Browser, und die Ausgabe ist wie folgt:

Die Ausgabe 'Content-type:text/html\\r\\n\\r\\n' in der ersten Zeile des Skripts wird an den Browser gesendet, um den Browser darüber zu informieren, dass der anzuzeigende Inhaltstyp 'text/html' ist.


HTTP-Header

Der Eintrag 'Content-type:text/html' im Inhalt der Datei test.cgi ist Teil des HTTP-Headers. Er wird an den Browser gesendet, um ihm den Inhaltstyp der Datei mitzuteilen.

Das Format des HTTP-Headers ist wie folgt:

HTTP 字段名: 字段内容

Zum Beispiel:

Content-type:text/html\r\n\r\n

Die folgende Tabelle beschreibt die in CGI-Programmen häufig in HTTP-Headers verwendeten Informationen:

headBeschreibung
Content-type: MIME-Informationen, die der angeforderten Entität entsprechen. Zum Beispiel: Content-type:text/html
Expires: Datum Das Datum und die Uhrzeit, zu der die Antwort abläuft
Location: URL Wird verwendet, um den Empfänger zu einem anderen Ort als der angeforderten URL umzuleiten, um die Anforderung abzuschließen oder eine neue Ressource zu identifizieren
Last-modified: DatumDie letzte Änderungszeit der angeforderten Ressource
Content-length: NDie Inhaltslänge der Anforderung
Set-Cookie: String HTTP-Cookie setzen

CGI-Umgebungsvariablen

Alle CGI-Programme erhalten die folgenden Umgebungsvariablen, die in CGI-Programmen eine wichtige Rolle spielen:

VariablennameBeschreibung
CONTENT_TYPEDer Wert dieser Umgebungsvariable gibt den MIME-Typ der übertragenen Informationen an. Derzeit ist die Umgebungsvariable CONTENT_TYPE im Allgemeinen: application/x-www-form-urlencoded, was angibt, dass die Daten aus einem HTML-Formular stammen.
CONTENT_LENGTHWenn die Übertragungsmethode zwischen dem Server und dem CGI-Programm POST ist, ist diese Umgebungsvariable die Anzahl der gültigen Datenbytes, die von der Standardeingabe STDIN gelesen werden können. Diese Umgebungsvariable muss beim Lesen der Eingabedaten verwendet werden.
HTTP_COOKIEDer COOKIE-Inhalt im Client.
HTTP_USER_AGENTStellt Client-Browser-Informationen bereit, die Versionsnummern oder andere proprietäre Daten enthalten.
PATH_INFODer Wert dieser Umgebungsvariable stellt weitere Pfadinformationen dar, die unmittelbar auf den Namen des CGI-Programms folgen. Er erscheint häufig als Parameter für das CGI-Programm.
QUERY_STRINGWenn die Übertragungsmethode zwischen dem Server und dem CGI-Programm GET ist, ist der Wert dieser Umgebungsvariable die übertragene Information. Diese Information folgt auf den Namen des CGI-Programms und ist durch ein Fragezeichen '?' getrennt.
REMOTE_ADDRDer Wert dieser Umgebungsvariable ist die IP-Adresse des Clients, der die Anfrage stellt, zum Beispiel 192.168.1.67 oben. Dieser Wert ist immer vorhanden. Er ist auch die eindeutige Kennung, die ein Web-Client dem Webserver bereitstellen muss, und er kann in CGI-Programmen verwendet werden, um verschiedene Web-Clients zu unterscheiden.
REMOTE_HOSTDer Wert dieser Umgebungsvariable enthält den Hostnamen des Clients, der die CGI-Anfrage gesendet hat. Wenn der Server die gewünschte Namensauflösung nicht unterstützt, muss diese Umgebungsvariable nicht definiert sein.
REQUEST_METHODGibt die Methode an, mit der das Skript aufgerufen wurde. Bei Skripten, die das HTTP/1.0-Protokoll verwenden, sind nur GET und POST sinnvoll.
SCRIPT_FILENAMEDer vollständige Pfad zum CGI-Skript
SCRIPT_NAMEDer Name des CGI-Skripts
SERVER_NAMEDies ist der Hostname, der Alias oder die IP-Adresse Ihres Webservers.
SERVER_SOFTWAREDer Wert dieser Umgebungsvariable enthält den Namen und die Versionsnummer des HTTP-Servers, der das CGI-Programm aufgerufen hat. Zum Beispiel ist der obige Wert Apache/2.2.14(Unix).

Das folgende ist ein einfaches CGI-Skript, das CGI-Umgebungsvariablen ausgibt:

Beispiel

#!/usr/bin/perl print "Content-type: text/html\n\n"; print '<meta charset="utf-8">'; print "<font size=+1>Umgebungsvariablen:</font>\n"; foreach (sort keys %ENV) { print "<b>$_</b>: $ENV{$_}<br>\n"; } 1;

Dateidownload

Wenn wir einen Dateidownload über Perl CGI implementieren möchten, müssen wir unterschiedliche Header-Informationen festlegen, wie folgt:

Beispiel

#!/usr/bin/perl # HTTP-Header print "Content-Type:application/octet-stream; name=\"FileName\"\r\n"; print "Content-Disposition: attachment; filename=\"FileName\"\r\n\n"; # Der tatsächliche Dateiinhalt kommt hierhin. open( FILE, "<FileName" ); while(read(FILE, $buffer, 100) ) { print("$buffer"); }

Verwendung der GET-Methode zur Datenübertragung

Die GET-Methode sendet kodierte Benutzerinformationen an den Server. Die Daten sind in der URL der angeforderten Seite enthalten, getrennt durch ein '?'-Zeichen, wie unten gezeigt:

http://www.test.com/cgi-bin/test.cgi?key1=value1&key2=value2
Einige weitere Hinweise zu GET-Anfragen:
  • GET-Anfragen können zwischengespeichert werden
  • GET-Anfragen bleiben im Browserverlauf
  • GET-Anfragen können als Lesezeichen gespeichert werden
  • GET-Anfragen sollten nicht verwendet werden, wenn sensible Daten verarbeitet werden
  • GET-Anfragen haben eine Längenbegrenzung
  • GET-Anfragen sollten nur zum Abrufen von Daten verwendet werden

Einfaches URL-Beispiel: GET-Methode

Das Folgende ist eine einfache URL, die zwei Parameter mithilfe der GET-Methode an das Programm test.cgi sendet:

/cgi-bin/test.cgi?name=Example&url=http://www.example.com

Das Folgende ist der Code für die Datei test.cgi:

Beispiel

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Textinformationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "GET") { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } $name = $FORM{name}; $url = $FORM{url}; print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2>$nameURL:$url</h2>"; print "</body>"; print "</html>"; 1;

Betrachtet man es im Browser, sieht die Ausgabe wie folgt aus:

Einfaches Formularbeispiel: GET-Methode

Das Folgende ist ein HTML-Formular, das die GET-Methode verwendet, um zwei Datenelemente an den Server zu senden. Das übermittelte Serverskript ist ebenfalls die Datei test.cgi. Der Code von test.html lautet wie folgt:

Code der Datei test.html

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="get">Seitenname:<input type="text" name="name"> <br />Website-URL:<input type="text" name="url" /> <input type="submit" value="Absenden" /> </form> </body> </html>

Im Browser sieht die Ausführung wie folgt aus:


Verwenden der POST-Methode zum Übergeben von Daten

Die Verwendung der POST-Methode zum Übergeben von Daten an den Server ist sicherer und zuverlässiger. Sensible Informationen wie Benutzerpasswörter müssen mit POST übertragen werden.

Das Folgende ist ebenfalls test.cgi; es kann auch vom Browser übermittelte POST-Formulardaten verarbeiten:

test.cgi-Code

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Textinformationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "POST") { read(STDIN, $buffer, $ENV{'CONTENT_LENGTH'}); }else { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } $name = $FORM{name}; $url = $FORM{url}; print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2>$nameURL:$url</h2>"; print "</body>"; print "</html>"; 1;

Das Folgende ist ein HTML-Formular, das die GET-Methode verwendet, um zwei Datenelemente an den Server zu senden. Das übermittelte Serverskript ist ebenfalls die Datei test.cgi. Der Code von test.html lautet wie folgt:

test.html-Code

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="post">Seitenname:<input type="text" name="name"> <br />Website-URL:<input type="text" name="url" /> <input type="submit" value="Absenden" /> </form> </body> </html>

Im Browser sieht die Ausführung wie folgt aus:

Übermitteln von Checkbox-Daten über ein CGI-Programm

Checkbox wird verwendet, um eine oder mehrere Optionsdaten zu übermitteln. Der test.html-Code lautet wie folgt:

test.html-Code

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="POST" target="_blank"> <input type="checkbox" name="example" value="on" />Beispiel-Tutorial<input type="checkbox" name="google" value="on" /> Google <input type="submit" value="Website auswählen" /> </form> </body> </html>

Das Folgende ist der Code der Datei test.cgi:

test.cgi-Code

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Informationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "POST") { read(STDIN, $buffer, $ENV{'CONTENT_LENGTH'}); }else { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } if( $FORM{example} ){ $example_flag ="ON"; }else{ $example_flag ="OFF"; } if( $FORM{google} ){ $google_flag ="ON"; }else{ $google_flag ="OFF"; } print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2> Ausgewählter Status des Beispiel-Tutorials :$example_flag</h2>"; print "<h2> Ausgewählter Status von Google :$google_flag</h2>"; print "</body>"; print "</html>"; 1;

Im Browser sieht die Ausführung wie folgt aus:


Übermitteln von Radiobutton-Daten über ein CGI-Programm

Ein Radiobutton sendet nur ein Datenelement an den Server. Der Code in test.html lautet wie folgt:

test.html-Code

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="post" target="_blank"> <input type="radio" name="site" value="example" />Beispiel-Tutorial<input type="radio" name="site" value="google" /> Google <input type="submit" value="Submit" /> </form> </body> </html>

Der Code des test.cgi-Skripts lautet wie folgt:

test.cgi-Code

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Informationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "POST") { read(STDIN, $buffer, $ENV{'CONTENT_LENGTH'}); }else { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } $site = $FORM{site}; print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2> Ausgewählte Website$site</h2>"; print "</body>"; print "</html>"; 1;

Im Browser sieht die Ausführung wie folgt aus:


Übermitteln von Textarea-Daten über ein CGI-Programm

Textarea sendet mehrere Datenzeilen an den Server. Der Code von test.html lautet wie folgt:

test.html-Code

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="post" target="_blank"> <textarea name="textcontent" cols="40" rows="4">Inhalt hier eingeben...</textarea> <input type="submit" value="Submit" /> </form> </body> </html>

Der Code des test.cgi-Skripts lautet wie folgt:

test.cgi-Code

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Informationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "POST") { read(STDIN, $buffer, $ENV{'CONTENT_LENGTH'}); }else { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } $text_content = $FORM{textcontent}; print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Beispiel-Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2> Der eingegebene Textinhalt ist:$text_content</h2>"; print "</body>"; print "</html>"; 1;

Im Browser sieht die Ausführung wie folgt aus:


Übergeben von Dropdown-Daten über ein CGI-Programm

Der Code für das HTML-Dropdown-Feld lautet wie folgt:

test.html-Code

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Beispiel-Tutorial (example.com)</title> </head> <body> <form action="/cgi-bin/test.cgi" method="post" target="_blank"> <select name="dropdown"> <option value="example" selected>Beispiel-Tutorial</option> <option value="google">Google</option> </select> <input type="submit" value="Absenden"/> </form> </body> </html>

Der Code des test.cgi-Skripts lautet wie folgt:

test.cgi-Code

#!/usr/bin/perl local ($buffer, @pairs, $pair, $name, $value, %FORM); # Informationen lesen $ENV{'REQUEST_METHOD'} =~ tr/a-z/A-Z/; if ($ENV{'REQUEST_METHOD'} eq "POST") { read(STDIN, $buffer, $ENV{'CONTENT_LENGTH'}); }else { $buffer = $ENV{'QUERY_STRING'}; } # Name/Wert-Paar-Informationen lesen @pairs = split(/&/, $buffer); foreach $pair (@pairs) { ($name, $value) = split(/=/, $pair); $value =~ tr/+/ /; $value =~ s/%(..)/pack("C", hex($1))/eg; $FORM{$name} = $value; } $site = $FORM{dropdown}; print "Content-type:text/html\r\n\r\n"; print "<html>"; print "<head>"; print '<meta charset="utf-8">'; print '<title>Example Tutorial (example.com)</title>'; print "</head>"; print "<body>"; print "<h2> Die ausgewählte Website ist:$site</h2>"; print "</body>"; print "</html>"; 1;

Im Browser sieht die Ausführung wie folgt aus:


Verwendung von Cookies in CGI

Ein großer Nachteil des HTTP-Protokolls ist, dass es die Benutzeridentität nicht beurteilt, was Programmierern große Unannehmlichkeiten bereitet. Das Aufkommen der Cookie-Funktionalität macht diesen Mangel wett.

Ein Cookie entsteht, wenn ein Client ein Skript besucht und über den Browser des Clients Daten auf die Festplatte des Clients geschrieben werden. Wenn der Client das nächste Mal auf das Skript zugreift, werden die Dateninformationen abgerufen, wodurch die Funktion der Identitätsbestimmung erreicht wird. Cookies werden üblicherweise zur Identitätsprüfung verwendet.

 

Cookie-Syntax

HTTP-Cookies werden über den HTTP-Header gesendet, was vor der Dateiübertragung geschieht. Die Syntax des Set-Cookie-Headers lautet wie folgt:

Set-cookie:name=name;expires=date;path=path;domain=domain;secure 
  • name=name:Der Cookie-Wert muss gesetzt werden (name darf nicht das Symbol ";",verwenden), wenn mehrere name-Werte vorhanden sind, mit ";" trennen, zum Beispiel:name1=name1;name2=name2;name3=name3。
  • expires=date:Gültigkeitsdauer des Cookies, Format: expires="Wdy,DD-Mon-YYYY HH:MM:SS"
  • path=path: Legt den vom Cookie unterstützten Pfad fest. Wenn path ein Pfad ist, gilt das Cookie für alle Dateien und Unterverzeichnisse unter diesem Verzeichnis, zum Beispiel: path="/cgi-bin/". Wenn path eine Datei ist, gilt das Cookie nur für diese Datei, zum Beispiel: path="/cgi-bin/cookie.cgi".
  • domain=domain:Der Domänenname, für den das Cookie gültig ist, zum Beispiel: domain="www.example.com"
  • secure:Wenn dieses Flag gesetzt ist, bedeutet das, dass das Cookie nur über einen HTTPS-Server unter Verwendung des SSL-Protokolls übertragen werden kann.
  • Der Cookie-Empfang wird durch Setzen der Umgebungsvariablen HTTP_COOKIE implementiert. CGI-Programme können Cookie-Informationen abrufen, indem sie diese Variable abfragen.

Cookies setzen

Das Setzen von Cookies ist sehr einfach; Cookies werden separat im HTTP-Header gesendet. Das folgende Beispiel setzt UserID, Password und expires im Cookie:

Beispiel

#!/usr/bin/perl print "Set-Cookie:UserID=XYZ;\n"; print "Set-Cookie:Password=XYZ123;\n"; print "Set-Cookie:Expires=Tuesday, 31-Dec-2017 23:12:40 GMT";\n"; print "Set-Cookie:Domain=www.example.com;\n"; print "Set-Cookie:Path=/perl;\n"; print "Content-type:text/html\r\n\r\n"; ...........weiterer HTML-Inhalt

Cookies abrufen

Die Seite zum Abrufen der Cookie-Informationen ist sehr einfach. Cookie-Informationen werden in der CGI-Umgebungsvariablen HTTP_COOKIE im folgenden Format gespeichert:

Beispiel

#!/usr/bin/perl $rcvd_cookies = $ENV{'HTTP_COOKIE'}; @cookies = split /;/, $rcvd_cookies; foreach $cookie ( @cookies ){ ($key, $val) = split(/=/, $cookie); # teilt beim ersten =. $key =~ s/^\s+//; $val =~ s/^\s+//; $key =~ s/\s+$//; $val =~ s/\s+$//; if( $key eq "UserID" ){ $user_id = $val; }elsif($key eq "Passwort"){ $password = $val; } } print "Benutzer-ID = $user_id\n"; print "Passwort = $password\n";

Das Ausgabeergebnis des obigen Beispiels ist:

User ID = XYZ
Password = XYZ123

CGI-Modul

Perl bietet viele integrierte CGI-Module, die folgenden zwei werden häufig verwendet:

Andere Erweiterungen