PHP programlama dili, dışarıdaki dosyaları php dosyamıza dahil etmek için çeşitli fonksiyonlar sağlar. Bu fonksiyonlar;
- include()
- require()
- include_once()
- require_once()
include() ve require() fonksiyonlar verdikleri hata dışında, aynı özelliklere sahiptir.
- include(), sadece bir uyarı (E_WARNING) oluşturur ve sonraki kodları çalıştırmaya devam eder.
- require(), ölümcül (fatal) bir uyarı (E_COMPILE_ERROR) oluşturur ve sonraki kodların çalıştırmasını durdurur.
Daha basit ifadelerle anlatmamız gerekirse, bir dosyayı require() fonksiyonu kullanarak çağırdığımızda bu dosyaya kesin olarak ihtiyacımız vardır. Bu dosya projemiz için olmazsa olmazdır. Bu yüzden projemiz ölümcül hata atar ve çalışmaz. Ancak dosyayı include() edersek, dosya belirtilen yolda yok ise PHP kodlarımız çalışmaya devam edebilir. include() fonksiyonu sadece bir uyarı oluşturur. Yani include() ve require() fonksiyonlarımızın çalışma mantıkları aynıdır.
PHP include() Fonksiyonu
PHP include() fonksiyonu, bir PHP programı içine dış dosya ekler. Dış dosya yolunu kabul eder ve dosyanın var olup olmadığını kontrol eder. Belirtilen dosya yolunda dosya yok ise, include() fonksiyonu PHP warning uyarısı döndürür.
Warning: failed to open stream: No such file or directory...
Warning: Failed opening ... for inclusion...include() fonksiyonu içerisine yazılan dosya yolundaki dosyanın içinde bahiscom tanımlanan değişkenler, fonksiyonlar ve sınıflar , dosyayı include() ettiğimiz php dosyasında kullanılabilir.
<?php
include("../file_name.php"); // relative path //bağıntılı yol
//veya
include("/xampp/hddocs/file_name.php"); // absolute path //kesin yol
?>PHP require() Fonksiyonu
PHP require() fonksiyonu, include() fonksiyonu gibidir. Yani dışarıdan eklemek istediğimiz dosyayı PHP programına içine ekler. Fakat bir fark vardır. Belirtilen dosya yolunda dosyayı bulamaz ise, require() fonksiyonu ölümcül bir hata döndürür ve programın çalışmasını durdurur.
Warning: failed to open stream: No such file or directory...
Fatal error: Failed opening required...
<?php
require("../file_name.php"); // relative path //bağıntılı yol
//veya
require("/xampp/hddocs/file_name.php"); // absolute path //kesin yol
?>PHP include_once() and require_once() Fonksiyonları
include_once() ve require_once() fonksiyonları include() ve require() fonksiyonları ile benzerdir. Tek farkları, belirtilen dosyanın daha önce çağırılıp çağırılmadığını kontrol eder. Eğer dosya bir kez çağırılmış ise, tekrar çağırmazlar.
<?php
include_once("../file_name.php"); // relative path //bağıntılı yol
//veya
include_once("/xampp/hddocs/file_name.php"); // absolute path //kesin yol
?>
<?php
require_once("../file_name.php"); // relative path //bağıntılı yol
//veya
require_once("/xampp/hddocs/file_name.php"); // absolute path //kesin yol
?>
Kaynaklar:
https://www.php.net/manual/en/language.control-structures.php
https://www.w3schools.com/php/php_includes.asp
https://phppot.com/php/comparison-between-include-and-require-statements-in-php/
