fwrite

    (PHP 4, PHP 5, PHP 7, PHP 8)

    fwrite — Binär-sicheres Dateischreiben

    Beschreibung

    fwrite(resource$stream, string$data, ?int$length = null): int|false

    fwrite() schreibt den Inhalt der Zeichenkette data in die Datei, auf welche der Dateizeiger stream zeigt.

    Parameter-Liste

    stream

    Eine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird.

    data

    Die zu schreibende Zeichenkette.

    length

    Wenn Parameter length eine Integer ist, wird das Schreiben nach length Bytes beendet, oder wenn das Ende von data erreicht ist, je nachdem was eher eintritt.

    Rückgabewerte

    fwrite() gibt die Anzahl der geschriebenen Bytes zurück. Bei einem Fehler wird false zurückgegeben.

    Fehler/Exceptions

    fwrite() erzeugt bei einem Fehler ein E_WARNING.

    Changelog

    VersionBeschreibung
    8.0.0length ist jetzt nullbar.

    Beispiele

    Beispiel #1 Ein einfaches Beispiel für fwrite()

    <?php
    $filename     = 'test.txt';
    $somecontent = "Füge dies der Datei hinzu\n";

    // Sichergehen, dass die Datei existiert und beschreibbar ist.
    if (is_writable($filename)) {

    // Wir öffnen $filename im Anfüge-Modus.

    Anmerkungen

    Hinweis:

    Das Schreiben in einen Netzwerkstream kann enden, bevor die gesamte Zeichenkette geschrieben wurde. Der Rückgabewert von fwrite() kann wie folgt überprüft werden:

    <?php
    function fwrite_stream($fp, $string) {
    for (    $written = 0; $written < strlen($string); $written += $fwrite) {
    $fwrite = fwrite($fp, substr($string, $written));
    if (    $fwrite === false) {
    return     $written;
    }
    }
    return     $written;
    }
    ?>

    Hinweis:

    Auf Systemen, welche zwischen Binär- und Textdateien unterscheiden (z. B. Windows), muss die Datei mit dem fopen()-Modus-Parameter 'b' geöffnet werden.

    Hinweis:

    Wurde stream mit fopen() im Anfügemodus geöffnet, ist das Schreiben mit fwrite() atomar (außer wenn die Länge von data die Blockgröße des Dateisystems auf manchen Systemen überschreitet, und solange sich die Datei in einem lokalen Dateisystem befindet), d. h. es besteht keine Notwendigkeit, eine Ressource vor dem Aufruf von fwrite() mit flock() zu sperren; alle Daten werden ohne Unterbrechung geschrieben.

    Hinweis:

    Wird zweimalig in den Dateizeiger geschrieben, werden die Daten an das Ende des Dateiinhalts angehängt:

    <?php
    $fp     = fopen('data.txt', 'w');
    fwrite($fp, '1');
    fwrite($fp, '23');
    fclose($fp);

    // der Inhalt von 'data.txt' ist nun 123 und nicht 23!
    ?>

    Siehe auch

    • fread() - Liest Binärdaten aus einer Datei
    • fopen() - Öffnet eine Datei oder URL
    • fsockopen() - Stellt eine Internet- oder Unix-Domain-Socket-Verbindung her
    • popen() - Öffnet einen Dateizeiger für einen Prozess
    • file_get_contents() - Liest die gesamte Datei in einen String
    • pack() - Packt Daten in eine binäre Zeichenkette
    To Top