Fonksiyon require_once

require_once fonksiyonu, belirtilen dosyayı mevcut betiğe bağlar. Eğer dosya daha önce bağlanmışsa, fonksiyon onu tekrar bağlamaz. Bu, özellikle sınıf veya fonksiyon içeren dosyaları bağlarken, tekrar bağlamanın hatalara neden olabileceği durumlarda kullanışlıdır.

Sözdizimi

require_once 'path/to/file.php';

Örnek

config.php dosyasını bağlayalım:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Kodun çalıştırılmasının sonucu (eğer config.php'de $config dizisi tanımlanmışsa):

'My Site'

Örnek

Aynı dosyayı tekrar bağlama girişimi:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Bu çağrı yok sayılacak
	echo sum(2, 3);
?>

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

5

require'dan Farkı

require'dan farklı olarak, require_once fonksiyonu dosyanın daha önce bağlanıp bağlanmadığını kontrol eder ve tekrar bağlama işlemini gerçekleştirmez. Bu, aynı dosyanın birden fazla kez dahil edilmesinden kaynaklanan hataları önler.

Ayrıca Bakınız

include fonksiyonu,
aynı zamanda dosyaları bağlar ancak tekrar dahil edilmelerini kontrol etmez
include_once fonksiyonu,
require_once ile benzer şekilde çalışır ancak dosya bulunamadığında ölümcül hata vermez