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

phpinclude_once 'path/to/file.php';

Příklad

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

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

Výsledek provedení kódu:

phpWarning: 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<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

Viz také