Funkcia require_once

Funkcia require_once pripojí zadaný súbor do aktuálneho skriptu. Ak bol súbor už predtým pripojený, funkcia ho nebude pripájať znova. Je to obzvlášť užitočné pre pripájanie súborov s triedami alebo funkciami, kde opakované pripojenie môže spôsobiť chyby.

Syntax

require_once 'path/to/file.php';

Príklad

Pripájame súbor config.php:

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

Výsledok vykonania kódu (ak je v config.php definované pole $config):

'My Site'

Príklad

Pokus o opakované pripojenie toho istého súboru:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Toto volanie bude ignorované
	echo sum(2, 3);
?>

Výsledok vykonania kódu:

5

Rozdiel oproti require

Na rozdiel od require, funkcia require_once kontroluje, či bol súbor už pripojený, a nevykonáva opakované pripojenie. Toto zabraňuje chybám pri viacnásobnom zahrnutí toho istého súboru.

Pozri tiež

funkciu include,
ktorá tiež pripája súbory, ale nekontroluje ich opakované zahrnutie
funkciu include_once,
ktorá funguje podobne ako require_once, ale nespôsobí fatálnu chybu pri neprítomnosti súboru