PHP file_put_contents()Функции
Полное справочное руководство по файловой системе PHP
Определение и использование
Функция file_put_contents() записывает строку в файл.
При доступе к файлу эта функция следует следующим правилам:
- Если установлен FILE_USE_INCLUDE_PATH, будет проверен встроенный путь копии *filename*
- Если файл не существует, файл будет создан
- Открыть файл
- Если установлен LOCK_EX, файл будет заблокирован
- Если установлен FILE_APPEND, он переместится в конец файла. В противном случае содержимое файла будет очищено
- Записать данные в файл
- Закрыть файл и разблокировать все файлы
При успешном выполнении функция возвращает количество символов, записанных в файл. В случае сбоя она возвращает False.
Синтаксис
int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )
| Параметр | Описание |
|---|---|
| filename | Обязательный. Указывает файл, в который записываются данные. Если файл не существует, создаётся новый файл. |
| data | Обязательный. Указывает данные для записи в файл. Может быть строкой, потоком данных или массивом. |
| флаги | Необязательный. Указывает, как открывать/записывать файл. Возможные значения:
|
| context | Необязательный. Указывает окружение дескриптора файла. context — это набор параметров, которые могут изменять поведение потока. |
Советы и примечания
Примечание:Используйте FILE_APPEND, чтобы не удалять существующее содержимое файла.
Пример
Пример
echo file_put_contents("sites.txt","Пример");
Вывод приведенного выше примера:
6
Далее мы добавляем содержимое в файл sites.txt:
Пример
$file = 'sites.txt';
$site = "\nGoogle";
//Добавление содержимого в файл
//С помощью флага FILE_APPEND содержимое можно добавить в конец файла
//Флаг LOCK_EX может предотвратить одновременную запись несколькими людьми
file_put_contents($file, $site, FILE_APPEND | LOCK_EX);
После успешного выполнения откройте файл sites.txt, содержимое:
Example Google
Другие расширения