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` деп коюлса, функция файлды издөөдө PHP'нин жөндөөлөрүндөгү `php.ini` файлындагы include_path параметринде белгиленген директорияларды карайт. Демейки `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 функциясын,
ал файлды саптар массивине окуйт