ფუნქცია file_get_contents

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

მესამე პარამეტრი განსაკუთრებით სასარგებლოა, როდესაც საჭიროა ფაილების ძიება PHP-ის კონფიგურაციაში მითითებულ სტანდარტულ დირექტორიებში, და არა მხოლოდ აბსოლუტური გზით.

სინტაქსი

file_get_contents(
	string $filename,
	bool $use_include_path = false,
	?resource $context = null,
	int $offset = 0,
	?int $maxlen = null
): string|false

პარამეტრები

პარამეტრი	აღწერა
`filename`	ფაილის ან URL-ის გზა
`use_include_path`	თუ დაყენებულია `true`-ზე, ფუნქცია ეძებს ფაილს იმ დირექტორიებში, რომლებიც მითითებულია include_path პარამეტრში PHP-ის პარამეტრებში, ფაილში `php.ini`. ნაგულისხმევად `false`.
`context`	ნაკადის კონტექსტის რესურსი
`offset`	წანაცვლება კითხვის დასაწყებად
`maxlen`	წაკითხული მონაცემების მაქსიმალური სიგრძე

მაგალითი

ლოკალური ფაილის შიგთავსის კითხვა:

<?php
	$res = file_get_contents('data.txt');
	echo $res;
?>

კოდის შესრულების შედეგი:

'abcde'

მაგალითი

ფაილის ნაწილის კითხვა წანაცვლებისა და სიგრძის მითითებით:

<?php
	$res = file_get_contents('data.txt', false, null, 1, 3);
	echo $res;
?>

კოდის შესრულების შედეგი:

'bcd'

მაგალითი

ვებ-გვერდის შიგთავსის კითხვა:

<?php
	$res = file_get_contents('https://example.com');
	echo substr($res, 0, 50) . '...';
?>

კოდის შესრულების შედეგი:

'<!doctype html><html><head><title>Example D...'

მაგალითი

ფაილის ძიება include_path-ში:

<?php
	$res = file_get_contents('config.ini', true);
	echo $res;
?>

კოდის შესრულების შედეგი:

'config_data'

ნაკადის კონტექსტის პარამეტრი

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

კონტექსტის რესურსი, რომელიც created ფუნქციის მიერ stream_context_create. თუ არ არის საჭირო განსაკუთრებული კონფიგურაცია, შეგიძლიათ გადასცეთ null.

კონტექსტის შესაძლებლობები:

HTTP-სათაურების დაყენება მოთხოვნების დროს
დაკავშირების დროის შეზღუდვის კონფიგურაცია
პროქსი სერვერის მითითება
მუშაობა SSL/TLS პარამეტრებთან
ფაილური სისტემის წვდომის კონფიგურაცია

მუშაობის მაგალითი:

<?php
	$opts = [
		'http' => [
			'method' => "GET",
			'header' => "Accept-language: en\r\n"
		]
	];
	$context = stream_context_create($opts);
	$res = file_get_contents('https://example.com', false, $context);
?>

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

ფუნქცია file_put_contents,
რომელიც ჩაწერს მონაცემებს ფაილში
ფუნქცია fopen,
რომელიც ხსნის ფაილს
ფუნქცია file,
რომელიც კითხულობს ფაილს სტრიქონების მასივში