Fungsi file_get_contents

Fungsi file_get_contents membaca kandungan fail dan mengembalikannya sebagai rentetan. Parameter pertama ialah laluan ke fail, parameter kedua - tanda untuk memasukkan laluan carian, parameter ketiga - konteks strim, parameter keempat - ofset untuk mula membaca, parameter kelima - panjang maksimum data.

Parameter ketiga amat berguna apabila perlu mencari fail dalam direktori piawai, yang dinyatakan dalam konfigurasi PHP, dan bukan hanya melalui laluan mutlak.

Sintaks

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

Parameter

Parameter	Penerangan
`filename`	Laluan ke fail atau URL
`use_include_path`	Jika ditetapkan kepada `true`, fungsi akan mencari fail dalam direktori, yang dinyatakan dalam parameter include_path dalam tetapan PHP dalam fail `php.ini`. Secara lalai `false`.
`context`	Sumber konteks strim
`offset`	Ofset untuk mula membaca
`maxlen`	Panjang maksimum data yang dibaca

Contoh

Membaca kandungan fail tempatan:

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

Hasil pelaksanaan kod:

'abcde'

Contoh

Membaca sebahagian fail dengan menentukan ofset dan panjang:

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

Hasil pelaksanaan kod:

'bcd'

Contoh

Membaca kandungan halaman web:

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

Hasil pelaksanaan kod:

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

Contoh

Mencari fail dalam include_path:

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

Hasil pelaksanaan kod:

'config_data'

Parameter konteks strim

Parameter context membenarkan penghantaran sumber konteks strim, yang boleh mengubah suai tingkah laku fungsi semasa bekerja dengan fail atau sumber rangkaian.

Sumber konteks, dicipta oleh fungsi stream_context_create. Jika tiada tetapan khas diperlukan, boleh hantar null.

Kebolehan konteks:

Menetapkan pengepala HTTP semasa permintaan
Mengkonfigurasi masa tamat sambungan
Menentukan pelayan proksi
Bekerja dengan parameter SSL/TLS
Mengkonfigurasi akses kepada sistem fail

Contoh kerja:

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

Lihat juga

fungsi file_put_contents,
yang menulis data ke fail
fungsi fopen,
yang membuka fail
fungsi file,
yang membaca fail ke dalam tatasusunan rentetan