Funksie file_get_contents

Die funksie file_get_contents lees die inhoud van 'n lêer en gee dit terug as 'n string. Aan die eerste parameter word die pad na die lêer oorgedra, aan die tweede - die vlag om die soekpad in te sluit, aan die derde - die stroomkonteks, aan die vierde - die verskuiwing om te begin lees, en aan die vyfde - die maksimum lengte van die data.

Die derde parameter is veral nuttig wanneer jy lêers moet soek in die standaard gidse wat in die PHP konfigurasie gespesifiseer is, en nie net volgens die absolute pad nie.

Sintaksis

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

Parameters

Parameter	Beskrywing
`filename`	Pad na die lêer of URL
`use_include_path`	Indien gestel op `true`, sal die funksie die lêer soek in die gidse, gespesifiseer in die parameter include_path in die PHP-instellings in die lêer `php.ini`. Standaard is dit `false`.
`context`	Stroomkonteks hulpbron
`offset`	Verskuiwing om te begin lees
`maxlen`	Maksimum lengte van data om te lees

Voorbeeld

Lees die inhoud van 'n plaaslike lêer:

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

Resultaat van kode-uitvoering:

'abcde'

Voorbeeld

Lees 'n gedeelte van die lêer met die spesifisering van verskuiwing en lengte:

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

Resultaat van kode-uitvoering:

'bcd'

Voorbeeld

Lees die inhoud van 'n webbladsy:

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

Resultaat van kode-uitvoering:

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

Voorbeeld

Soek 'n lêer in include_path:

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

Resultaat van kode-uitvoering:

'config_data'

Stroomkonteks Parameter

Die parameter context laat jou toe om 'n stroomkonteks hulpbron oor te dra, wat die gedrag van die funksie kan wysig wanneer dit met lêers werk of netwerkhulpbronne.

'n Stroomkonteks hulpbron, geskep deur die funksie stream_context_create. As geen spesifieke instellings benodig word nie, kan jy null oordra.

Vermoëns van die konteks:

Stel HTTP-hoofde in tydens versoeke
Stel verbinding-timeouts op
Spesifiseer 'n proxy-bediener
Werk met SSL/TLS parameters
Stel toegang tot die lêerstelsel op

Voorbeeld van werk:

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

Sien ook

die funksie file_put_contents,
wat data na 'n lêer skryf
die funksie fopen,
wat 'n lêer oopmaak
die funksie file,
wat 'n lêer in 'n array van strings lees