PHP: fwrite - Manual

Opis

int fwrite ( resource uchwyt, string łańcuch [, int długość] )

fwrite() zapisuje treść łańcuch do strumienia pliku wskazanego przez uchwyt. Jeśli argument długość został podany, zapis zatrzymywany jest po zapisaniu długość bajtów lub łańcuch skończy się, cokolwiek nastąpi szybciej.

fwrite() zwraca liczbę zapisanych bajtów, lub FALSE w przypadku błędu.

Zauważ, że jeśli argument długość zosta podany, to konfiguracja magic_quotes_runtime zostaje zignorowana i żadne slashe nie zostaną usunięte z łańcucha.

Notatka: W systemach, które rozróżniają pliki na binarne i tekstowe (np. Windows) plik musi zostać otworzony z 'b' włączonym do parametru tryb funkcji fopen().

Przykład 1. Prosty przykład fwrite


<?php 

  $nazwapliku = 'test.txt'; 

  $trochetresci = "Dodaj to do pliku\n"; 

    

  // Najpierw przekonaj się czy plik istnieje i jest zapisywalny. 

  if (is_writable($nazwapliku)) { 

    

      // W naszym przykładzie otwieramy $nazwapliku w trybie dopisywania. 

      // Wskaźnik pliku jest ustawiony na końcu pliku gdzie znajdzie 

      // się zawartość $trochetresci po wykonaniu fwrite(). 

      if (!$uchwyt = fopen($nazwapliku, 'a')) { 

           echo "Nie mogę otworzyć pliku ($nazwapliku)"; 

           exit; 

      } 

    

      // Zapis $trochetresci do naszego otwartego pliku. 

      if (fwrite($uchwyt, $trochetresci) === FALSE) { 

          echo "Nie mogę zapisać do pliku ($nazwapliku)"; 

          exit; 

      } 

    

      echo "Sukces, zapisano ($trochetresci) do pliku ($nazwapliku)"; 

    

      fclose($uchwyt); 

    

  } else { 

      echo "Plik $nazwapliku nie jest zapisywalny"; 

  } 

  ?>

Patrz także: fread(), fopen(), fsockopen(), popen() i file_put_contents().

User Contributed Notes


> In PHP 4.3.7 fwrite returns 0 rather than false on

> failure.



Actually it can return any of these:

-NULL,

-0,

-FALSE



This means instead of writing the example shown:

<?php

if (fwrite($handle, $somecontent) === FALSE) { //code

}

?>



You could write something shorter like:

<?php

if ( !fwrite($handle, $somecontent) ) { //code

}

?>



It is a better coding to define the ! (is not) before the arguments.  But both work fine.


chill at cuna dot org wrote:



> In PHP 4.3.7 fwrite returns 0 rather than false on

> failure.



This is true (under certain circumstances) in (at least) PHP

4 and 5.  I filed it as a bug (see [1]) but it's the

intended behavior -- writing less than the requested number

of bytes is not considered an error.



This means that you should only consider an fwrite

successful if its return value is the same as the length of

the string you passed to it.  (fwrite fails in this

particular way if the filesystem is full, or if the file was

opened in read-only mode, and probably in yet other

situations.)



fwrite does return false (and trigger a warning) in certain

cases; e.g., when it's passed an invalid file handle.



[1] <http://bugs.php.net/bug.php?id=34860>



-- 

Aaron