[Ben]

Textdateien: Lesen und Schreiben von Inhalten

Oftmals möchte man einfach nur zuvor erstellten Text in einer Textdatei ablegen bzw. den Inhalt einer solchen Datei auslesen, um ihn weiterzuverarbeiten, wie z.B. in einem Gästebuch.


Da sich der Programmcode aber im großen und ganzen immer gleicht schreiben wir uns zwei kleine Funktionen, die uns das ständige Implementieren des Lese- und Schreibvorgangs ersparen.



Eine Datei auslesen

Wir geben zu Beginn den Namen der Datei an, die wir auslesen wollen.

PHP-Code:

<?php

    $datei = 'test.txt';
    
?>

Es ist dabei egal, welche Endung die Datei hat. Die Endung, in diesem Fall .txt, ist frei wählbar.

Die Funktion "leseAusDatei()" erwartet als Übergabeparameter den Namen der Datei. In der Funktion wird abgesichert, dass die Datei existiert, das sie lesbar ist und das keine Fehler beim Lesen aus der Datei aufgetreten sind.
Nur wenn alle diese Prüfungen erfolgreich sind liefert die Funktion den Inhalt der Datei als Zeichenkette zurück.

PHP-Code:

<?php

    function leseAusDatei( $datei ) {
        if ( !file_exists( $datei ) ) {
            printf( 'Die Datei %s konnte nicht gefunden werden.
                       <br />
                       Bitte Pfadangaben überprüfen.', 
                       $datei );
            return false;
        }

        if ( !is_readable( $datei ) ) {
            printf( 'Die Datei %s konnte nicht gelesen werden', $datei );
            return false;
        }

        if ( !$inhalt = file_get_contents( $datei ) ) {
            printf( 'Es trat ein Fehler beim Lesen der Datei %s auf.', $datei );
            return false;
        }

        return $inhalt;
    }

?>

Es gibt mehrere Wege eine Datei auszulesen. Diese Codepassage

PHP-Code:

<?php

        if ( !$inhalt = file_get_contents( $datei ) ) {
            printf( 'Es trat ein Fehler beim Lesen der Datei %s auf.', $datei );
            return false;
        }

?>

kann auch mittels der Funktionen file() oder fread() realisiert werden. Dabei ist zu beachten, dass in diesen Fällen eine Verzeichnisresource (ein 'handle') mittels fopen() erstellt werden muss.

In diesem Beitrag wollen wir uns auf die Methode file_get_contents() beschränken.


In eine Datei schreiben

Die Funktion "schreibeInDatei()" erwartet als Übergabeparameter zum Einen den Namen der Datei und zum Anderen den einzufügenden Inhalt, also eine Zeichenkette.

Es wird wiederum getestet, ob die Datei existiert und ob sie die benötigten Schreibrechte besitzt.

PHP-Code:

<?php

    function schreibeInDatei( $datei, $inhalt ) {
        if ( !file_exists( $datei ) ) {
            printf( 'Die Datei %s konnte nicht gefunden werden.
                        <br />
                        Bitte Pfadangaben überprüfen.', 
                        $datei );
            return false;
        }

        if ( !is_writable( $datei ) ) {
            printf( 'Die Datei %s kann nicht beschrieben werden', $datei );
            return false;
        }

        if ( !$handle = fopen( $datei, "w") ) {
            printf( 'Die Datei %s kann nicht geöffnet werden', $datei );
            return false;
        }

        if ( !fwrite( $handle, $inhalt ) ) {
            printf( 'Es trat ein Fehler beim Schreiben des Inhalts in die Datei %s auf.', $datei );
            return false;
        }

        fclose( $handle );
    }

?>

In dieser Funktion wird nun das oben angesprochene Verfahren verwendet. Es wird eine Resource mittels fopen() erstellt und dann mit fwrite() der Inhalt in die Datei geschrieben.
Ab PHP 5 steht alternativ die Funktion file_put_contents() für das Schreiben in Dateien zur Verfügung.

Es ist zu beachten, dass der hier vorgestellte Quelltext sich nicht mit der Überprüfung des Inhalts oder der Bearbeitung mit Funktionen wie z.B. addslashes() oder strip_tags() befasst.

Das sollte dann nach individuellem Bedürfnis angepasst werden.

Die Funktionen "leseAusDatei" und "schreibeInDatei" können jetzt z.B. folgendermaßen vernwendet werden.

PHP-Code:

<?php

    $inhalt = leseAusDatei( $datei );

    if( trim($inhalt) == '' ) {
        $inhalt = 0;
    }

    echo '<br />Inhalt der Textdatei: ' . $inhalt  . '<br />';

    schreibeInDatei( $datei, ++$inhalt );

    echo '<a href="' . $_SERVER['PHP_SELF'] . '">Seite neu laden</a>';

?>

Diese Codepassage liest den Inhalt einer Datei aus und überprüft, ob überhaupt etwas in der Datei drinsteht. Ist dies nicht der Fall wird der Variablen "$inhalt" der Zahlenwert "0" zugewiesen.
Nach der Testausgabe wird dann die Datei neu beschrieben. Als einzufügender Text wird die Variable "$inhalt" inkrementiert, also um eins erhöht.
Durch den Link, der die Seite selbst aufruft haben wir uns somit einen ganz simplen Counter gebaut


Ich rate jedem, der sich mit Textdateien und dem Dateisystem als solchem beschäftigen möchte das entsprechende Kapitel im Manual durchzuarbeiten. Dort findet man jede Hilfe, die man benötigt.
XXXVII. Funktionen des Dateisystems (deutsch)
XXXVII. Filesystem Functions (englische Originalversion)

Viel Spaß beim Anwenden

Ich hoffe, dass Euch die Antwort auf die Frage 'wie man mit Textdateien lesend und schreiben zugreift' weitergeholfen hat.
Solltet Ihr Fragen haben, so schreibt bitte einen Beitrag im Anfänger-Forum mit einem Verweis auf diesen FAQ-Beitrag.
Danke.

Ich hoffe, dass ich Euch hier etwas weiterhelfen konnte.
Bei Verbesserungsvorschlägen würde ich mich über eine Nachricht freuen.

[Ben]

Interessante Beiträge im Forum

Frage zum Gästebuch Tutorial


Eventuell hilft Euch ja der ein oder andere Beitrag noch weiter

Wenn Ihr Fragen habt, dann stehen wir Euch gerne in den Foren zur Verfügung.

Grüße Ben