Funkce require_once

Funkce require_once připojí zadaný soubor do aktuálního skriptu. Pokud byl soubor již dříve připojen, funkce jej znovu nepřipojí. To je obzvláště užitečné pro připojování souborů s třídami nebo funkcemi, kde opakované připojení může způsobit chyby.

Syntaxe

require_once 'path/to/file.php';

Příklad

Připojme soubor config.php:

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

Výsledek provedení kódu (pokud je v config.php definováno pole $config):

'Můj web'

Příklad

Pokus o opakované připojení stejného souboru:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Toto volání bude ignorováno
	echo sum(2, 3);
?>

Výsledek provedení kódu:

5

Rozdíl oproti require

Na rozdíl od require funkce require_once kontroluje, zda byl soubor již připojen, a neprovádí opakované připojení. Tím se zabrání chybám při vícenásobném připojení stejného souboru.

Viz také

funkci include,
která také připojuje soubory, ale nekontroluje jejich opakované připojení
funkci include_once,
která funguje podobně jako require_once, ale nezpůsobí fatální chybu při absenci souboru