ფუნქცია file_put_contents

ფუნქცია file_put_contents წერს მონაცემებს ფაილში. პირველი პარამეტრი - გზა ფაილამდე, მეორე - მონაცემები ჩასაწერად. მესამე არასავალდებულო პარამეტრი განსაზღვრავს ჩაწერის რეჟიმს (იხ. ცხრილი ქვემოთ).

მეოთხე არასავალდებულო პარამეტრი წარმოადგენს ნაკადის კონტექსტის რესურსს, რომელიც შექმნილია ფუნქციის stream_context_create მიერ. საშუალებას აძლევს კონფიგურირება გაუკეთოს ფაილთან ან ქსელურ რესურსთან მუშაობის პარამეტრებს.

სინტაქსი

phpfile_put_contents(
  string $filename,
  mixed $data,
  int $flags = 0,
  ?resource $context = null
): int|false

მესამე პარამეტრის მნიშვნელობები

ფლაგი აღწერა
FILE_USE_INCLUDE_PATH თუ დაყენებულია, ფუნქცია ეძებს ფაილს დირექტორიებში, რომლებიც მითითებულია პარამეტრში include_path PHP-ის კონფიგურაციაში ფაილში php.ini.
FILE_APPEND მონაცემების დამატება ფაილის ბოლოში ხელახალი ჩაწერის ნაცვლად
LOCK_EX ფაილის ექსკლუზიური ბლოკირების მოპოვება ჩაწერის დროს

მაგალითი

მოდით ჩავწეროთ სტრიქონი ფაილში:

php<?php
  $res = file_put_contents('data.txt', 'abcde');
  echo $res;
?>

კოდის შესრულების შედეგი აბრუნებს ჩაწერილი ბაიტების რაოდენობას:

php5

მაგალითი

მოდით დავამატოთ მონაცემები ფაილის ბოლოში:

php<?php
  $res = file_put_contents('data.txt', '12345', FILE_APPEND);
  echo $res;
?>

მაგალითი

მასივის ჩაწერა ფაილში:

php<?php
  $data = ['a', 'b', 'c'];
  $res = file_put_contents('array.txt', implode(',', $data));
  echo $res;
?>

მაგალითი

მესამე პარამეტრში შესაძლებელია მრავალი ფლაგის მითითება, ჩამოთვლით მათ | სიმბოლოს მეშვეობით. მაგალითისთვის დავამატოთ მონაცემები ფაილის ბლოკირებით:

php<?php
  $res = file_put_contents(
    'log.txt',
    "text",
    FILE_APPEND | LOCK_EX
  );
  echo $res;
?>

მაგალითი

კონტექსტის გამოყენება:

php<?php
  $opts = [
    'http' => [
      'method' => "POST",
      'header' => "Content-type: text/plain\r\n"
    ]
  ];
  
  $context = stream_context_create($opts);
  
  $res = file_put_contents(
    'http://example.com/api',
    'data=test',
    false,
    $context
  );
?>

იხილეთ აგრეთვე

  • ფუნქცია file_get_contents,
    რომელიც კითხულობს ფაილის შიგთავსს
  • ფუნქცია fopen,
    რომელიც ხსნის ფაილს
  • ფუნქცია fwrite,
    რომელიც წერს ფაილში