file_put_contentsЗаписывает данные в файл
&reftitle.description;
intfalsefile_put_contentsstringfilenamemixeddataintflags0resourcenullcontext&null;
Функция работает так же, как последовательный вызов функций
fopen, fwrite
и fclose для записи данных в файл.
Если путь filename не существует, функция создаст файл.
В противном случае она перезапишет существующий файл,
если не установлен флаг FILE_APPEND.
&reftitle.parameters;
filename
Путь к файлу, в который функция будет записывать данные.
data
Записываемые данные. Разрешено передавать строку (string),
массив (array) или ресурс потока.
Если данные data — ресурс потока
(stream), функция скопирует оставшийся буфер потока
в файл. Это похоже на работу функции
stream_copy_to_stream.
Допустимо определять параметр data
как одномерный массив. Это будет эквивалентно вызову
file_put_contents($filename, implode('', $array)).
flags
В параметр flags разрешено передавать
произвольные комбинации следующих флагов, соединяя их бинарным
оператором ИЛИ (|).
Доступные флагиФлагОписаниеFILE_USE_INCLUDE_PATH
Ищет файл filename
во включённых каталогах.
Параграф include_path
даёт дополнительную информацию.
FILE_APPEND
Функция допишет данные в конец файла вместо того, чтобы перезаписать его,
если файл filename уже существует.
LOCK_EX
Получает эксклюзивную блокировку файла на время записи. Другими словами,
между вызовами функций fopen и fwrite
произойдёт вызов функции flock. Это не тождественно
вызову функции fopen с флагом «x».
context
Допустимый ресурс контекста, который создан функцией
stream_context_create.
&reftitle.returnvalues;
Функция возвращает количество байтов, которые процесс записал в файл,
или &false; в случае ошибки.
&return.falseproblem;
&reftitle.examples;
Пример простого использования
]]>
Использование флагов
]]>
&reftitle.notes;
¬e.bin-safe;
&tip.fopen-wrapper;
&reftitle.seealso;
fopenfwritefile_get_contentsstream_context_create