(PHP 4, PHP 5, PHP 7, PHP 8)
fwrite — Binär-sicheres Dateischreiben
fwrite() schreibt den Inhalt der Zeichenkette
data in die Datei, auf welche der Dateizeiger
stream zeigt.
streamEine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird.
dataDie 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.
fwrite() gibt die Anzahl der geschriebenen Bytes zurück.
Bei einem Fehler wird false zurückgegeben.
fwrite() erzeugt bei einem Fehler ein
E_WARNING.
| Version | Beschreibung |
|---|---|
| 8.0.0 |
length ist jetzt nullbar.
|
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.
// Der Dateizeiger befindet sich am Ende der Datei, und daher
// wird später $somecontent mit fwrite() dorthin geschrieben.
if (!$fp = fopen($filename, "a")) {
print "Kann die Datei $filename nicht öffnen";
exit;
}
// Schreibe $somecontent in die geöffnete Datei.
if (fwrite($fp, $somecontent) === FALSE) {
print "Kann nicht in die Datei $filename schreiben";
exit;
}
print "Fertig, in die Datei $filename wurde $somecontent geschrieben";
fclose($fp);
} else {
print "Die Datei $filename ist nicht schreibbar";
}
?>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
streammit fopen() im Anfügemodus geöffnet, ist das Schreiben mit fwrite() atomar (außer wenn die Länge vondatadie 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!
?>