file_put_contents

(PHP 5)

file_put_contents - Записать строку в файл

Описание

int file_put_contents ( string filename, mixed data [, int flags [, resource context]] )

Функция идентична последовательному вызову функций fopen(), fwrite() и fclose(). Возвращаемым функцией значением является количество записанных в файл байтов.

Параметр flags может принимать значение FILE_USE_INCLUDE_PATH и/или FILE_APPEND. Используйте FILE_USE_INCLUDE_PATH с осторожностью.

Также вы можете передать (одномерный) массив в качестве параметра data. Это будет эквивалентно вызову file_put_contents($filename, join('', $array)).

Начиная с версии PHP 5.1.0, вы также можете передавать ресурс потока в качестве аргумента data. В результате оставшийся буфер этого потока будет скопирован в указанный файл. Это похоже на использование stream_copy_to_stream().

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Подсказка: Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция "fopen wrappers". Смотрите более подробную информацию об определении имени файла в описании функции fopen(), а также список поддерживаемых протоколов URL в Прил. M.

Эмулятор функции file_put_contents для PHP < 5:

function file_put_contents( $n, $d )
{
   $f = @fopen ( $n, "w" );
   if ( !$f )
    return false;
   else {
    fwrite ( $f, $d );
    fclose ( $f );
    return true;
    }
}

См.также описания функций fopen(), fwrite(), fclose() и file_get_contents().

Смотрите также:
Все функции файл
Описание на ru2.php.net
Описание на php.ru