English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

PHP базовый курс

PHP продвинутый курс

PHP и MySQL

PHP справочник

PHP функция file_put_contents() и примеры использования

PHP Filesystem справочник

Функция file_put_contents() может записать строку в файл.

Синтаксис

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

При доступе к файлу функция следует следующим правилам:

  1. Если установлен флаг FILE_USE_INCLUDE_PATH, то будет проверено встроенное путь для копии *filename*

  2. Если файл не существует, будет создан новый файл

  3. Открыть файл

  4. Если установлен флаг LOCK_EX, то файл будет заблокирован

  5. Если установлен флаг FILE_APPEND, то курсор будет перемещен в конец файла. В противном случае, содержимое файла будет очищено

  6. Запись данных в файл

  7. Закрыть файл и разблокировать все файлы

Если функция успешна, она может вернуть количество символов, записанных в файл. Если функция失败了, она может вернуть false.

Параметры

ПараметрыОписание
fileОбязательно. Указать файл, в который нужно записать данные. Если файл не существует, будет создан новый файл.
dataОбязательно. Указать данные, которые нужно записать в файл. Это может быть строка, массив или поток данных.
modeОпционально. Указать способ открытия/записи файла. Возможные значения:
  • FILE_USE_INCLUDE_PATH

  • FILE_APPEND

  • LOCK_EX

contextОпционально. Указать環境ные параметры файлового дескриптора. Context — это набор опций, которые можно использовать для изменения поведения потока.

Пример 1

Запись содержимого в файл sample.txt

<?php
   echo file_put_contents("sample.txt", "Hello World!");
?>

Результат вывода

11

Пример 2

Использование способа FILE_APPEND для добавления содержимого, чтобы избежать удаления существующего содержимого файла.

<?php
   $file = "sample.txt";
   // новый пользователь, который нужно добавить в файл
   $test = " w3codebox";
   // использовать флаг FILE_APPEND, чтобы добавить содержимое в конец файла
   // а также флаг LOCK_EX, чтобы предотвратить одновременную запись в файл любым другим пользователем
   file_put_contents($file, $test, FILE_APPEND | LOCK_EX);
   echo "Содержание успешно добавлено в файл.";
?>

Результат вывода

Содержание успешно добавлено в файл.

PHP Filesystem справочник