Функция file_put_contents в PHP: руководство, примеры и синтаксис

Функция file_put_contents в PHP позволяет записать данные в файл. Она имеет следующий синтаксис:

file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] ) : int|false

Первый аргумент - это имя файла, в который будут записаны данные. Второй аргумент - данные, которые нужно записать. Они могут быть представлены строкой, массивом или объектом, который может быть преобразован в строку. Третий аргумент - это флаги, которые могут изменять поведение функции. Четвертый аргумент - это контекст потока, если требуется.

Пример использования функции:

$data = "Some data to write to a file.";
$file = "example.txt";
file_put_contents($file, $data);

В этом примере функция записывает строку `$data` в файл `$file`. Если файл не существует, он будет создан. Если файл уже существует, то его содержимое будет перезаписано данными, переданными в функцию.

Также можно использовать функцию для добавления данных в конец файла, используя флаг FILE_APPEND:

$data = "Some more data to append.";
$file = "example.txt";
file_put_contents($file, $data, FILE_APPEND);

В этом примере функция добавляет строку `$data` в конец файла `$file`.

Использование контекста потока

Функцию file_put_contents можно использовать вместе с контекстом потока для дополнительной настройки записи данных. Например, можно использовать контекст для установки блокировки файла:

$data = "Data to write with a lock.";
$file = "example.txt";
$context = stream_context_create([
    'file' => [
        'lock' => FILE_LOCK_EX
    ]
]);
file_put_contents($file, $data, 0, $context);

В этом примере мы создаем контекст потока, который устанавливает блокировку файла (`FILE_LOCK_EX`). Затем мы передаем контекст в функцию `file_put_contents`, чтобы записать данные в файл.

В заключение, функция file_put_contents - это простой и удобный способ записи данных в файл. Она может быть использована для записи строк, массивов и объектов в файлы. Кроме того, она имеет ряд опций, которые позволяют настраивать запись данных.