Funkcia include_once

Funkcia include_once pripája zadaný súbor do aktuálneho PHP skriptu, ale iba ak nebol pripojený predtým. Je to obzvlášť užitočné pri práci so súbormi, ktoré obsahujú deklarácie funkcií alebo tried, aby sa predišlo chybám opätovnej deklarácie. Do parametra funkcie sa odovzdáva cesta k pripájanému súboru.

Syntax

include_once 'path/to/file.php';

Príklad

Pripojíme súbor config.php iba raz:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Toto volanie bude ignorované
?>

Príklad

Pokus o pripojenie neexistujúceho súboru:

<?php
	include_once 'nonexistent.php'; // Spôsobí varovanie, ale nezastaví vykonávanie skriptu
	echo 'Script continues...';
?>

Výsledok vykonania kódu:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Príklad

Použitie premennej na určenie cesty:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Pozrite tiež

funkciu include,
ktorá pripája súbor bez kontroly na opätovné zahrnutie
funkciu require,
ktorá pripája súbor so zastavením skriptu pri chybe
funkciu require_once,
ktorá funguje ako include_once, ale zastaví skript pri chybe