fwrite

(PHP 3, PHP 4, PHP 5)

fwrite -- Бинарно-безопасная запись в файл

Описание

int fwrite ( resource handle, string string [, int length] )

fwrite() записывает содержимое string в файловый поток handle. Если передан аргумент length, запись остановится после того, как length байтов будут записаны или будет достигнут конец строки string, смотря что произойдёт первым.

fwrite() возвращает количество записанных байтов или FALSE в случае ошибки.

Обратите внимание, что если аргумент length указан, то конфигурационная опция magic_quotes_runtime будет проигнорирована и строка string не будет очищена от слешей.

Замечание: В системах, различающих двоичные и текстовые файлы (к примеру, Windows), файл должен быть открыт используя флаг 'b' в конце аргумента mode функции fopen().

Пример 1. Простой пример использования fwrite

<?php
$filename
= 'test.txt';
$somecontent = "Добавить это к файлу\n";

// Вначале давайте убедимся, что файл существует и доступен для записи.
if (is_writable($filename)) {

    
// В нашем примере мы открываем $filename в режиме "дописать в конец".
    // Таким образом, смещение установлено в конец файла и
    // наш $somecontent допишется в конец при использовании fwrite().
    
if (!$handle = fopen($filename, 'a')) {
         echo
"Не могу открыть файл ($filename)";
         exit;
    }

    
// Записываем $somecontent в наш открытый файл.
    
if (fwrite($handle, $somecontent) === FALSE) {
        echo
"Не могу произвести запись в файл ($filename)";
        exit;
    }
    
    echo
"Ура! Записали ($somecontent) в файл ($filename)";
    
    
fclose($handle);

} else {
    echo
"Файл $filename недоступен для записи";
}
?>

См. также описание функций fread(), fopen(), fsockopen(), popen() и file_put_contents().