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 պարամետրը թույլ է տալիս փոխանցել հոսքի կոնտեքստի ռեսուրս, որը կարող է փոփոխել ֆունկցիայի վարքագիծը ֆայլերի կամ ցանցային ռեսուրսների հետ աշխատելիս:

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 ֆունկցիան,
որը ընթերցում է ֆայլը տողերի զանգվածի մեջ