[Ben]

Eingabeüberprüfung eines Formulars

Oftmals möchte man überprüfen, ob alle nötigen Eingaben eines Formulars gemacht wurden, beispielsweise bei einem Gästebuch oder einem Kontaktformular.

Dabei ist es natürlich komfortabel, wenn der User nach einer unzureichenden Eingabe, z.B. wenn eine Angabe vergessen wurde, nur diese eine Angabe ergänzen und nicht alle Eingaben nochmals tätigen muss.
Um diese Funktionalität zu realisieren nutzen wir Sessions.

Erstellen wir aber zunächst einmal ein Beispielformular. Dieses Formular wird an eine PHP-Datei geschickt, die dann die Überprüfung der Eingaben übernimmt.

<form action="ueberpruefung.php" method="post">

    <input type="text" name="name">
    <input type="text" name="email">

    <input type="hidden" name="gesendet" value="1">

    <input type="submit" name="abschicken" value="Weg damit">

</form>

Das macht nun genau das, was oben beschrieben wurde.

Schauen wir uns nun, die Datei "ueberpruefung.php" an.

Da wir eine Session brauchen starten wir diese zu Beginn mit session_start().

PHP-Code:

<?php

   // Session starten
   session_start();

?>

Da diese Datei nur dann durch das Formular aufgerufen werden soll, fragen wir ab, ob dies auch geschehen ist. Das machen wir, indem wir überprüfen, ob der Schlüssel "gesendet" des superglobalen Arrays $_POST gesetzt ist. Dieser Schlüssel entspricht dem im Formular definierten hidden-field.
Wurde die Datei direkt per URL aufgerufen, so wird der User zum Formular weitergeleitet.

PHP-Code:

<?php

   // Absicherung, dass die Datei auch über das Formular aufgerufen wurde
   if( isset($_POST['gesendet']) ) {
       // Eingabeprüfung
   }
   else {
       header( 'Location: http://localhost/formular.php' );
       exit();
    }
?>

Hier sei angemerkt, dass sowohl bei session_start(), als auch bei header() darauf zu achten ist, dass keine Ausgabe (auch keine Leerstelle) an den Browser gesendet wird, bevor diese Funktionen aufgerufen werden.


Wenden wir uns aber nun der Eingabeüberprüfung zu.

Zunächst einmal erstellen wir im Array $_SESSION den Schlüssel 'error' und weisen diesem ein Array zu. Wir haben somit ein mehrdimensionales Array.

PHP-Code:

<?php

        $_SESSION['error']  = array();

?>

Beim Absenden eines Formulars werden alle "values" der Formularelemente im Array $_POST abgespeichert, sofern im Formularkopf method="post" steht.

Wir verwenden also eine foreach-Schleife und durchlaufen so das Array.
Im Schleifenrumpf werden dann die Überprüfungen durchgeführt. In unserem Fall überprüfen wir zum Einen, ob überhaupt etwas eingegeben wurde und deuten dann noch eine Überprüfung der eMail-Adresse an.

PHP-Code:

<?php

        foreach( $_POST as $key => $value ) {
             // Ist überhaupt etwas geschrieben worden?
             if( strcmp(trim($value),'') == 0 ) {
                 $_SESSION['error'][] = $key;
             }
             else {
                 if( strcmp($key,'email') ) {
                       ueberpruefeMail($value);
                 }
                 else {
                       $_SESSION[$key] = $value;
                 }
             }
        }

Wenn keine Angabe gemacht wurde wird der Name des Formularfelds, also der entsprechende Schlüssel aus dem Array $_POST, als Element der zweiten Dimension zu $_SESSION['error'] hinzugefügt.
Ist eine Angabe gemacht worden, so wird diese dem entsprechenden Schlüssel (= Formularfeld) zugewiesen.


Nun müssen wir natürlich auch noch überprüfen, ob ein Fehler aufgetreten ist oder nicht. Sind die Angaben nicht vollständig oder nicht korrekt, so wird der User per header() wieder zurück zum Formular geleitet.
Ist kein Fehler entdeckt worden wird das Formular so verarbeitet, wie es gewünscht ist.

PHP-Code:

<?php

        if( count($_SESSION['error']) > 0 ) {
             header( 'Location: [url]http://localhost/formular.php[/url] ' );
             exit();
        }
        else {
             // Hier kann z.B. eine Mail abgeschickt und der User danach zu einer
             // Bestätigungsseite weitergeleitet werden.
             header( 'Location: http://localhost/bestaetigung.php' );
             exit();
        }

?>

Der interessante Teil ist nun natürlich der Fall, wenn Fehler aufgetreten sind.
Wir müssen unsere Datei mit dem Formular etwas umbauen, um den gewünschten Komfort zu erreichen.

Wir müssen natürlich auch hier eine Session starten, da wir ja auf die Inhalte der Session-Variablen zugreifen wollen.

PHP-Code:

<?php

   // Session starten
   session_start();

?>

Um dem User auch optisch anzuzeigen, wo er seine Angabe verbessern bzw. komplettieren muss bauen wir noch ein kleines Feature ein. Die Beschriftung des Textfeldes wird farbig, in diesem Falle rot, dargestellt, wenn die Eingabe nicht korrekt war.
Das erfordert eine kleine Variablendefinition:

PHP-Code:

<?php

   // Definition der Schriftfarbe bei inkorrekter Eingabe
   $cssErrorVorne  = '<span style="color:#ff0000;">';
   $cssErrorHinten = '</span>';

?>

Nun geht es ans Eingemachte
Wir erstellen ein Array, welches die anzuzeigenden Fehler enthält.
Wir füllen es, indem wir mittels einer foreach-Schleife durch das Array $_SESSION['error'] laufen und die Schlüssel der zweiten Dimension dem zweidimensionalen Array "$_error" hinzufügen.

PHP-Code:

<?php

   // Array, welches die anzuzeigenden Fehler enthält
   $_error = array();

   foreach( $_SESSION['error'] as $key ) {
        $_error[$key]['vorne']  = $cssErrorVorne;
        $_error[$key]['hinten'] = $cssErrorHinten;
   }

?>

Das mag nun auf den ersten Blick etwas komisch erscheinen, allerdings wird es durch den letzten Codeschnipsel sicherlich klarer.
Wir geben also nun das Formular aus. Dabei halten wir die Werte des Attributs "value", sowie die farbliche Markierung bei einem Fehler variabel.

PHP-Code:

<?php

   printf( '<form action="ueberpruefung.php" method="post">

               %sName:%s <input type="text" name="vorname" value="%s">
               %sVorname:%s  <input type="text" name="nachname" value="%s">

               <input type="hidden" name="sent" value="1">
               <input type="submit" name="submit" value="Abschicken">

            </form>',
           $_error['name']['vorne'],
           $_error['name']['hinten'],
           $_SESSION['name'],
           $_error['email']['vorne'],
           $_error['email']['hinten'],
           $_SESSION['email'] );

?>

Somit wird da, wo denn eine korrekte Eingabe vorhanden war, diese auch angezeigt und die Beschriftung bleibt in der Originalfarbe. Dort wo aber keine bzw. eine falsche Angabe gemacht wurde bleibt das "value"-Attribut leer und die Beschriftung wird in der vorher definierten Farbe dargestellt.


Dieses Beispiel ist selbstverständlich noch stark erweiterbar. Vor allem im Bereich der eigentlichen Überprüfung sollte man sich etwas Zeit lassen und durch "Spielen" herausfinden, wie man die eigenen Überprüfungen. optimal realisieren kann.


Die verwendeten Funktionen findet man natürlich wie immer im offiziellen Manual.

Viel Spaß beim Basteln

Solltet Ihr Fragen zu dem Tutorial haben, so schreibt bitte einen Beitrag im PHP-Forum mit einem Verweis auf dieses Tutorial.
Danke.

Ich hoffe, dass ich Euch hier etwas weiterhelfen konnte.

Grüße Ben.

[Doggi]

printf( '<form action=ueberpruefung.html method="post">

müsste heißen

printf( '<form action=ueberpruefung.php method="post">

[Corvin]

Am besten:
printf( '<form action="ueberpruefung.php" method="post">

[Ben]

Hi,
der PHP-Highlighter frisst da irgendwas. Zitiert einfach mal meinen Code, dann seht ihr, dass ich die Anführungszeichen eingebaut habe.

Ich werde mal schauen, ob man diesen kleinen Bug irgendwie fixen kann.

Grüße Ben.

[Chr!s]

PHP-Code:

<?php

        if( $count($_SESSION['error']) > 0 ) {    
             header( 'Location: [url]http://localhost/formular.php[/url] ' );
             exit();   
        }
        else {        
             // Hier kann z.B. eine Mail abgeschickt und der User danach zu einer
             // Bestätigungsseite weitergeleitet werden.
             header( 'Location: http://localhost/bestaetigung.php' );
             exit();               
        }

?>

Erste Zeile-müsste es nicht count() statt $count() sein?

[Ben]

Danke schön . Wurde aktualisiert.

[PaterNoster]

Wenn man von dem Beispiel-Formular ausgeht, ist das hier falsch:

PHP-Code:

<?php

   printf( '<form action="ueberpruefung.php" method="post">
               
               %sName:%s <input type="text" name="vorname" value="%s">
               %sVorname:%s  <input type="text" name="nachname" value="%s">
               
               <input type="hidden" name="sent" value="1">
               <input type="submit" name="submit" value="Abschicken">
                 
            </form>',
           $_error['name']['vorne'],
           $_error['name']['hinten'],
           $_SESSION['name'],
           $_error['email']['vorne'],
           $_error['email']['hinten'],
           $_SESSION['email'] );
 
?>

Richtig wäre doch wohl

PHP-Code:

<?php

   printf( '<form action="ueberpruefung.php" method="post">
               
               %sName:%s <input type="text" name="name" value="%s"> //Hier
               %sE-Mail:%s  <input type="text" name="email" value="%s"> //...und hier
               
               <input type="hidden" name="sent" value="1">
               <input type="submit" name="submit" value="Abschicken">
                 
            </form>',
           $_error['name']['vorne'],
           $_error['name']['hinten'],
           $_SESSION['name'],
           $_error['email']['vorne'],
           $_error['email']['hinten'],
           $_SESSION['email'] );
 
?>

Nur ne Kleinigkeit, hat mich aber auf Anhieb doch ein wenig verwirrt