include_once funksiyası

include_once funksiyası göstərilən faylı cari PHP skriptinə birləşdirir, lakin yalnız əgər əvvəl birləşdirilməmişdisə. Bu, xüsusilə funksiyaların və ya siniflərin bəyanlarını ehtiva edən faylarla işləyərkən, təkrar bəyan səhvlərinin qarşısını almaq üçün faydalıdır. Funksiyanın parametrinə birləşdiriləcək faylın yolu ötürülür.

Sintaksis

include_once 'path/to/file.php';

Nümunə

Gəlin config.php faylını yalnız bir dəfə birləşdirək:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Bu çağırış laqeyd ediləcək
?>

Nümunə

Mövcud olmayan faylı birləşdirmək cəhdi:

<?php
	include_once 'nonexistent.php'; // Xəbərdarlığa səbəb olacaq, lakin skriptin icrasını dayandırmayacaq
	echo 'Skript davam edir...';
?>

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

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Nümunə

Yolu göstərmək üçün dəyişəndən istifadə:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Həmçinin baxın

include funksiyası,
təkrar daxil etmə yoxlaması olmadan faylı birləşdirir
require funksiyası,
səhv zamanı skripti dayandıraraq faylı birləşdirir
require_once funksiyası,
include_once kimi işləyir, lakin səhv zamanı skripti dayandırır