Функция PHP file_put_contents()
❮ Справочник по файловой системе PHPПример
Записать данные в файл:
<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>
Вывод кода выше будет:
21
Определение и использование
file_put_contents() записывает данные в файл.
Эта функция следует следующим правилам при доступе к файлу:
- Если установлен FILE_USE_INCLUDE_PATH, проверьте путь включения для копии имени файла .
- Создайте файл, если он не существует
- Откройте файл
- Заблокируйте файл, если установлено значение LOCK_EX.
- Если установлено FILE_APPEND, перейдите в конец файла. В противном случае очистите содержимое файла
- Запишите данные в файл
- Закройте файл и снимите все блокировки
Примечание. Используйте FILE_APPEND, чтобы избежать удаления существующего содержимого файла.
Синтаксис
file_put_contents(filename, data, mode, context)
Значения параметров
Parameter | Description |
---|---|
filename | Required. Specifies the path to the file to write to. If the file does not exist, this function will create one |
data | Required. The data to write to the file. Can be a string, array, or a data stream |
mode | Optional. Specifies how to open/write to the file. Possible values:
|
context | Optional. Specifies the context of the file handle. Context is a set of options that can modify the behavior of a stream. |
Технические детали
Возвращаемое значение: | Количество байтов, записанных в файл в случае успеха, FALSE в случае ошибки |
---|---|
Версия PHP: | 5.0+ |
Бинарный сейф: | да |
Журнал изменений PHP: | PHP 5.1 - Добавлена поддержка LOCK_EX и возможность передавать ресурс потока в параметр данных |
❮ Справочник по файловой системе PHP