ფუნქცია file_put_contents

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

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

სინტაქსი

file_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
	$res = file_put_contents('data.txt', 'abcde');
	echo $res;
?>

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

5

მაგალითი

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

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

მაგალითი

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

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

მაგალითი

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

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

მაგალითი

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

<?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,
რომელიც წერს ფაილში