file_get_contents funksiyası

file_get_contents funksiyası faylin məzmununu oxuyur və onu sətir şəklində qaytarır. Birinci parametrə faylın yolu ötürülür, ikinciyə - axtarış yolunun daxil edilmə bayrağı, üçüncüyə - axın konteksti, dördüncüyə - oxumanın başlanğıcı üçün ofset, beşinciyə - məlumatın maksimum uzunluğu.

Üçüncü parametr xüsusilə faydalıdır, when PHP konfiqurasiyasında göstərilən standart qovluqlarda faylları axtarmaq lazım olduqda, yalnız mütləq yol üzrə deyil.

Sintaksis

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

Parametrlər

Parametr	Təsvir
`filename`	Faylın yolu və ya URL
`use_include_path`	Əgər `true`-ya təyin edilibsə, funksiya faylı axtaracaq PHP-nin `php.ini` faylındakı parametrlərdə göstərilən include_path qovluqlarında. Default olaraq `false`.
`context`	Axın kontekstinin resursu
`offset`	Oxumanın başlanğıcı üçün ofset
`maxlen`	Oxunan məlumatın maksimum uzunluğu

Nümunə

Lokal faylın məzmununun oxunması:

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

Kodun icrasının nəticəsi:

'abcde'

Nümunə

Faylın hissəsinin ofset və uzunluq göstərilməklə oxunması:

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

Kodun icrasının nəticəsi:

'bcd'

Nümunə

Veb səhifənin məzmununun oxunması:

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

Kodun icrasının nəticəsi:

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

Nümunə

Faylın include_path-də axtarılması:

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

Kodun icrasının nəticəsi:

'config_data'

Axın kontekstinin parametri

context parametri axın kontekstinin resursunu ötürməyə imkan verir, bu da fayllarla və ya şəbəkə resursları ilə işləyərkən funksiyanın davranışını dəyişə bilər.

stream_context_create funksiyası tərəfindən yaradılmış kontekst resursu. Əgər xüsusi parametrlər tələb olunmursa, null ötürülə bilər.

Kontekstin imkanları:

Sorğularda HTTP başlıqlarının təyin edilməsi
Qoşulma timeout-larının konfiqurasiyası
Proxy serverinin göstərilməsi
SSL/TLS parametrləri ilə iş
Fayl sistemi girişinin konfiqurasiyası

İş nümunəsi:

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

Həmçinin bax

file_put_contents funksiyası,
hansı ki, məlumatı fayla yazır
fopen funksiyası,
hansı ki, faylı açır
file funksiyası,
hansı ki, faylı sətir massivinə oxuyur