(PHP 5)
file_put_contents — Записва низ във файл
Функцията извършва същото, както и последователността fopen(), fwrite() и fclose() (извикани успешно).
Ако файлът filename не съществува ще бъде създаден. Ако съществува ще бъде презаписан, освен ако не е подаден флаг FILE_APPEND.
Път до файла в който ще бъдат записвани данните.
Данните, който ще бъдат записани. Могат да са string, array или stream (както е обяснено по-горе).
Ако data е от тип stream, остатъкът в буфера на потока ще бъде записан в посочения файл. Това е подобно на използването на stream_copy_to_stream().
Също така, може да използвате параметъра data като едномерен масив. Това е равнозначно на file_put_contents($filename, implode('', $array)).
Стойността на 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. |
Валиден ресурс, създаден с 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 протоколи.