file_get_contents Fonksiyonu

file_get_contents fonksiyonu bir dosyanın içeriğini okur ve onu bir dize olarak döndürür. İlk parametreye dosya yolu, ikinci parametreye arama yolunun dahil edilme bayrağı, üçüncü parametreye akış bağlamı, dördüncü parametreye okumanın başlayacağı ofset, beşinci parametreye ise maksimum veri uzunluğu iletilir.

Üçüncü parametre, özellikle dosyaları mutlak yol yerine, PHP yapılandırmasında belirtilen standart dizinlerde aramak gerektiğinde kullanışlıdır.

Sözdizimi

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

Parametreler

Parametre	Açıklama
`filename`	Dosya yolu veya URL
`use_include_path`	`true` olarak ayarlanırsa, fonksiyon dosyayı PHP ayarlarındaki `php.ini` dosyasındaki include_path parametresinde belirtilen dizinlerde arayacaktır. Varsayılan olarak `false`.
`context`	Akış bağlamı kaynağı
`offset`	Okumanın başlayacağı ofset
`maxlen`	Okunacak verilerin maksimum uzunluğu

Örnek

Yerel bir dosyanın içeriğinin okunması:

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

Kodun çalıştırılmasının sonucu:

'abcde'

Örnek

Ofset ve uzunluk belirtilerek dosyanın bir bölümünün okunması:

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

Kodun çalıştırılmasının sonucu:

'bcd'

Örnek

Bir web sayfasının içeriğinin okunması:

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

Kodun çalıştırılmasının sonucu:

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

Örnek

include_path içinde dosya arama:

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

Kodun çalıştırılmasının sonucu:

'config_data'

Akış Bağlamı Parametresi

context parametresi, dosyalarla veya ağ kaynaklarıyla çalışırken fonksiyonun davranışını değiştirebilecek bir akış bağlamı kaynağı iletmeye izin verir.

stream_context_create fonksiyonu tarafından oluşturulan bir bağlam kaynağı. Özel bir ayar gerekmiyorsa, null iletilebilir.

Bağlamın olanakları:

İsteklerde HTTP başlıklarının ayarlanması
Bağlantı zaman aşımlarının yapılandırılması
Vekil sunucunun belirtilmesi
SSL/TLS parametreleriyle çalışma
Dosya sistemi erişiminin yapılandırılması

Çalışma örneği:

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

Ayrıca Bakınız

verileri bir dosyaya yazan file_put_contents
fonksiyonu
bir dosyayı açan fopen
fonksiyonu
bir dosyayı bir dizi dizisi olarak okuyan file
fonksiyonu