Funcția file_get_contents

Funcția file_get_contents citește conținutul unui fișier și îl returnează sub formă de șir. În primul parametru se transmite calea către fișier, în al doilea - un flag pentru activarea căii de căutare, în al treilea - contextul fluxului, în al patrulea - decalajul pentru începutul citirii, în al cincilea - lungimea maximă a datelor.

Al treilea parametru este util în special atunci când trebuie să căutați fișiere în directoarele standard, specificate în configurația PHP, și nu numai pe calea absolută.

Sintaxă

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

Parametrii

Parametru	Descriere
`filename`	Calea către fișier sau URL
`use_include_path`	Dacă este setat la `true`, funcția va căuta fișierul în directoarele specificate în parametrul include_path din setările PHP din fișierul `php.ini`. Implicit `false`.
`context`	Resursa contextului fluxului
`offset`	Decalaj pentru începutul citirii
`maxlen`	Lungimea maximă a datelor citite

Exemplu

Citirea conținutului unui fișier local:

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

Rezultatul executării codului:

'abcde'

Exemplu

Citirea unei părți a fișierului cu specificarea decalajului și lungimii:

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

Rezultatul executării codului:

'bcd'

Exemplu

Citirea conținutului unei pagini web:

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

Rezultatul executării codului:

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

Exemplu

Căutarea fișierului în include_path:

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

Rezultatul executării codului:

'config_data'

Parametrul contextului fluxului

Parametrul context permite transmiterea unei resurse de context a fluxului, care poate modifica comportamentul funcției atunci când lucrează cu fișiere sau resurse de rețea.

Resursa de context, creată de funcția stream_context_create. Dacă nu sunt necesare setări speciale, se poate transmite null.

Capabilitățile contextului:

Setarea antetelor HTTP la cereri
Configurarea timeout-urilor de conexiune
Specificarea serverului proxy
Lucrul cu parametrii SSL/TLS
Configurarea accesului la sistemul de fișiere

Exemplu de funcționare:

<?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);
?>

Vedeți și

funcția file_put_contents,
care scrie date într-un fișier
funcția fopen,
care deschide un fișier
funcția file,
care citește un fișier într-un tablou de șiruri