Funkcija file_get_contents

Funkcija file_get_contents nolasa faila saturu un atgriež to kā virkni. Pirmajā parametrā tiek padots ceļš uz failu, otrajā - slēdzis iekļaušanas ceļa meklēšanai, trešajā - straumes konteksts, ceturtajā - nobīde lasīšanas sākumam, piektajā - maksimālais datu garums.

Trešais parametrs ir īpaši noderīgs, kad nepieciešams meklēt failus standarta direktorijās, kas norādītas PHP konfigurācijā, nevis tikai pēc absolūtā ceļa.

Sintakse

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

Parametri

Parametrs	Apraksts
`filename`	Ceļš uz failu vai URL
`use_include_path`	Ja iestatīts uz `true`, funkcija meklēs failu direktorijās, kas norādītas parametrā include_path PHP iestatījumos failā `php.ini`. Pēc noklusējuma `false`.
`context`	Straumes konteksta resurss
`offset`	Nobīde lasīšanas sākumam
`maxlen`	Maksimālais lasāmo datu garums

Piemērs

Lokāla faila satura lasīšana:

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

Koda izpildes rezultāts:

'abcde'

Piemērs

Daļas faila lasīšana ar nobīdes un garuma norādīšanu:

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

Koda izpildes rezultāts:

'bcd'

Piemērs

Tīmekļa lapas satura lasīšana:

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

Koda izpildes rezultāts:

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

Piemērs

Faila meklēšana include_path:

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

Koda izpildes rezultāts:

'config_data'

Parametrs straumes konteksts

Parametrs context ļauj padot straumes konteksta resursu, kas var modificēt funkcijas darbību, strādājot ar failiem vai tīkla resursiem.

Konteksta resurss, kas izveidots ar funkciju stream_context_create. Ja nav nepieciešami īpaši iestatījumi, var padot null.

Konteksta iespējas:

HTTP galviņu iestatīšana pie pieprasījumiem
Savienojuma taimautu konfigurēšana
Starpniekservera norādīšana
Darbs ar SSL/TLS parametriem
Piekļuves failu sistēmai konfigurēšana

Darbības piemērs:

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

Skatiet arī

funkciju file_put_contents,
kas ieraksta datus failā
funkciju fopen,
kas atver failu
funkciju file,
kas nolasa failu virkņu masīvā