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

phpinclude_once 'path/to/file.php';

Príklad

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

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

Príklad

Pokus o pripojenie neexistujúceho súboru:

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

Výsledok vykonania kódu:

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

Pozrite tiež