Функсияи 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,
ки файлро ба массиви сатрҳо мехонад