require_once funksiyası

require_once funksiyası göstərilən faylı cari skriptə birləşdirir. Əgər fayl əvvəllər artıq birləşdirilibsə, funksiya onu yenidən birləşdirməyəcək. Bu, xüsusilə siniflər və ya funksiyalar olan faylları birləşdirmək üçün faydalıdır, burada təkrar birləşdirmə səhvlərə səbəb ola bilər.

Sintaksis

require_once 'path/to/file.php';

Nümunə

Gəlin config.php faylını birləşdirək:

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

Kodun icrasının nəticəsi (əgər config.php-də $config massivi təyin edilibsə):

'My Site'

Nümunə

Eyni faylı təkrar birləşdirməyə cəhd:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Bu çağırış laqeyd ediləcək
	echo sum(2, 3);
?>

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

5

require-dən fərq

require-dən fərqli olaraq, require_once funksiyası faylın artıq birləşdirilib-birləşdirilmədiyini yoxlayır və təkrar birləşdirməni yerinə yetirmir. Bu, eyni faylın dəfələrlə daxil edilməsi zamanı səhvlərin qarşısını alır.

Həmçinin bax

include funksiyasına,
o da faylları birləşdirir, lakin onların təkrar daxil edilməsini yoxlamır
include_once funksiyasına,
o, require_once kimi işləyir, lakin faylın olmaması halında fatal error səbəb olmur