Funkce include_once

Funkce include_once připojí zadaný soubor do aktuálního PHP skriptu, ale pouze pokud nebyl již dříve připojen. To je obzvláště užitečné při práci se soubory obsahujícími deklarace funkcí nebo tříd, aby se předešlo chybám opětovné deklarace. Parametr funkce obsahuje cestu k připojovanému souboru.

Syntaxe

include_once 'path/to/file.php';

Příklad

Připojíme soubor config.php pouze jednou:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Toto volání bude ignorováno
?>

Příklad

Pokus o připojení neexistujícího souboru:

<?php
	include_once 'nonexistent.php'; // Způsobí varování, ale nezastaví provedení skriptu
	echo 'Script continues...';
?>

Výsledek provedení kódu:

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

Příklad

Použití proměnné pro určení cesty:

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

Viz také

funkci include,
která připojuje soubor bez kontroly opětovného připojení
funkci require,
která připojuje soubor s zastavením skriptu při chybě
funkci require_once,
která funguje jako include_once, ale zastaví skript při chybě