array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'it', ), 'this' => array ( 0 => 'function.fwrite.php', 1 => 'fwrite', 2 => 'Scrittura su file binary-safe', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Filesystem Funzioni', ), 'prev' => array ( 0 => 'function.ftruncate.php', 1 => 'ftruncate', ), 'next' => array ( 0 => 'function.glob.php', 1 => 'glob', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'it', 'path' => 'reference/filesystem/functions/fwrite.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fwrite

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

fwrite — Scrittura su file binary-safe

Descrizione

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

fwrite() scrive il contenuto di data nello stream del file puntato da stream.

Elenco dei parametri

stream

Un puntatore a una resource di filesystem che è normalmente creata utilizzando fopen().

data

La stringa che deve essere scritta.

length

Se l'argomento length è un int, la scrittura si arresterà dopo aver scritto length byte o alla fine di data a seconda di quale dei due eventi si verifica prima.

Valori restituiti

fwrite() restituisce il numero di byte scritti, o false in caso di fallimento.

Errori/Eccezioni

fwrite() genera un E_WARNING in caso di errore.

Log delle modifiche

Versione Descrizione
8.0.0 Ora length è nullable.

Esempi

Example #1 Un esempio semplice di fwrite()

<?php
$filename = 'test.txt';
$somecontent = "Aggiungi questo al file\n";

// Assicuriamoci prima che il file esista e sia scrivibile.
if (is_writable($filename)) {

// Nel nostro esempio stiamo aprendo $filename in modalità append.
// Il puntatore del file si trova in fondo al file, quindi
// è lì che $somecontent verrà scritto quando lo scriviamo con fwrite().
if (!$fp = fopen($filename, 'a')) {
echo "Impossibile aprire il file ($filename)";
exit;
}

// Scriviamo $somecontent nel nostro file aperto.
if (fwrite($fp, $somecontent) === FALSE) {
echo "Impossibile scrivere nel file ($filename)";
exit;
}

echo "Successo, scritto ($somecontent) nel file ($filename)";

fclose($fp);

} else {
echo "Il file $filename non è scrivibile";
}
?>

Note

Nota:

Scrivere su uno stream di rete potrebbe terminare prima che l'intera stringa sia scritta. Il valore restituito da fwrite() potrebbe essere verificato:

<?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;
}
?>

Nota:

Su sistemi che differenziano tra file binari e di testo (ad esempio Windows), il file deve essere aperto con 'b' incluso nel parametro di modalità di fopen().

Nota:

Se stream è stato aperto in modalità append tramite fopen(), le scritture con fwrite() sono atomiche (a meno che la dimensione di data non superi la dimensione del blocco del filesystem, su alcune piattaforme, e purché il file sia su un filesystem locale). Cioè, non c'è bisogno di usare flock() prima di chiamare fwrite(); tutti i dati saranno scritti senza interruzione.

Nota:

Se si scrive due volte sul puntatore del file, i dati verranno aggiunti alla fine del contenuto del file:

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

// il contenuto di 'data.txt' è ora 123 e non 23!
?>

Vedere anche: