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

phprequire_once 'path/to/file.php';

Örnek

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

php<?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):

php'My Site'

Örnek

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

php<?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:

php5

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