require_once() funkcija vključi in preveri določeno datoteko med izvajanjem skripte. Obnašanje te funkcije je podobno funkciji require(), le da le-ta, če je datoteka že vključena, ne vključi datoteke ponovno. Poglejte si dokumentacijo funkcije require() za več informacij o delovanju te funkcije.
Funkcijo require_once() je najbolje uporabljati v primerih, kjer bi se lahko zgodilo, da bi datoteka lahko bila vključena večkrat. Z uporabo te funkcije zagotovite, da bo datoteka vključena samo enkrat, s čimer se izognete morebitnim redefinicijam funkcij, spreminjanje vrednosti spremenljivk, ipd.
Za primer uporabe funkcij require_once() in include_once(), si oglejte PEAR kodo, ki je vključena v zadnjo PHP distribucijo.
Opomba: require_once() funkcija je bila dodana v PHP 4.0.1pl2
Opomba: Bodite pozorni na obnašanje funkcij require_once() in include_once() v operacijskih sistemih, ki ne ločujejo malih črk od velikih (kot naprimer Windows).
Primer 11-8. require_once() is case sensitive
require_once("a.php"); // to bo vkljucilo datoteko a.php
require_once("A.php"); // to bo na Windowsih ponovno vkljucilo datoteko a.php
Pozor |
Različica PHP za okolje Windows trenutno ne podpira odpiranja oddaljenih datotek, tudi če je nastavitev allow_url_fopen vklopljena. |
Poglejte si: require(), include(), include_once(), get_required_files(), get_included_files(), readfile(), in virtual().