Funktsioon require_once

Funktsioon require_once ühendab määratud faili praegusse skripti. Kui fail on juba varem ühendatud, ei ühenda funktsioon seda uuesti. See on eriti kasulik klasside või funktsioonide failide ühendamiseks, kus korduv ühendamine võib põhjustada vigu.

Süntaks

require_once 'path/to/file.php';

Näide

Ühendame faili config.php:

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

Koodi täitmise tulemus (kui config.php-s on määratud massiiv $config):

'Minu Sait'

Näide

Sama faili korduva ühendamise katse:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // See kutse ignoreeritakse
	echo sum(2, 3);
?>

Koodi täitmise tulemus:

5

Erinevus require-st

Erinevalt require-st, funktsioon require_once kontrollib, kas fail on juba ühendatud, ja ei täida korduvat ühendamist. See hoiab ära vead, mis tekivad sama faili mitmekordsel kaasamisel.

Vaata ka

funktsiooni include,
mis samuti ühendab faile, kuid ei kontrolli nende korduvat kaasamist
funktsiooni include_once,
mis töötab sarnaselt require_once'ga, kuid ei põhjusta fatal errorit kui faili pole olemas