Функции за работа с файловата система
PHP Manual

file_put_contents

(PHP 5)

file_put_contentsЗаписва низ във файл

Описание

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

Функцията извършва същото, както и последователността fopen(), fwrite() и fclose() (извикани успешно).

Ако файлът filename не съществува ще бъде създаден. Ако съществува ще бъде презаписан, освен ако не е подаден флаг FILE_APPEND.

Параметри

filename

Път до файла в който ще бъдат записвани данните.

data

Данните, който ще бъдат записани. Могат да са string, array или stream (както е обяснено по-горе).

Ако 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 Придобива изключително заключване върху файла докато се записва в него.
FILE_TEXT Данните от data се записват в текстов режим. Ако се използва unicode семантика, кодирането по подразбиране ще е UTF-8. Можете да използвате различно кодиране чрез създаването на context или чрез използването на stream_default_encoding(), за да промените подразбиращото се кодиране. Този флаг не може да бъде използван едновременно с FILE_BINARY. Този флаг е наличен от PHP6.
FILE_BINARY Данните от data се записват в двоичен режим. Това е режимът използван по подразбиране. Не може да бъде използван едновременно с FILE_TEXT. Този флаг е наличен от PHP6.

context

Валиден ресурс, създаден с stream_context_create().

Връщани стойности

Функцията връща броя байтове, които са били записани във файла или FALSE при неуспех.

Дневник на промените

Версия Описание
5.0.0 Добавена е поддръжка за context.
5.1.0 Добавена е поддръжка за LOCK_EXи взможността да се подаде поток на параметър data .
6.0.0 Добавена е поддръжка за флаговете FILE_TEXT и FILE_BINARY

Бележки

Забележка: Тази функция е двоично сигурна (binary-safe).

Съвет

Даден URL може да бъде използван като име на файл с тази функция ако fopen wrappers е включено. Виж fopen() за повече подробности относно начина, по който се задава име на файл и List of Supported Protocols/Wrappers за списък с поддържаните URL протоколи.

Вж. също


Функции за работа с файловата система
PHP Manual