Ֆունկցիա require_once

Ֆունկցիան require_once նշված ֆայլը միացնում է ընթացիկ սկրիպտին: Եթե ֆայլն արդեն միացված է եղել նախկինում, ֆունկցիան այն չի միացնի կրկին: Սա հատկապես օգտակար է դասեր կամ ֆունկցիաներ պարունակող ֆայլեր միացնելիս, որտեղ կրկնակի միացումը կարող է սխալների հանգեցնել:

Շարահյուսություն

require_once 'path/to/file.php';

Օրինակ

Միացնենք config.php ֆայլը:

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

Կոդի կատարման արդյունքը (եթե config.php-ում սահմանված է $config զանգված):

'My Site'

Օրինակ

Նույն ֆայլի կրկնակի միացման փորձ.

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Այս կանչը կանտեսվի
	echo sum(2, 3);
?>

Կոդի կատարման արդյունքը.

5

Տարբերությունը require-ից

Ի տարբերություն require-ի, require_once ֆունկցիան ստուգում է, արդյոք ֆայլն արդեն միացված է, և չի կատարում կրկնակի միացում: Սա կանխում է սխալները նույն ֆայլի բազմակի ներառման դեպքում:

Տես նաև

include ֆունկցիան,
որը նույնպես միացնում է ֆայլեր, բայց չի ստուգում դրանց կրկնակի ներառումը
include_once ֆունկցիան,
որը գործում է նման require_once-ին, բայց չի առաջացնում ֆատալ սխալ, եթե ֆայլը բացակայում է