Funkce require_once

Funkce require_once připojí zadaný soubor do aktuálního skriptu. Pokud byl soubor již dříve připojen, funkce jej znovu nepřipojí. To je obzvláště užitečné pro připojování souborů s třídami nebo funkcemi, kde opakované připojení může způsobit chyby.

Syntaxe

phprequire_once 'path/to/file.php';

Příklad

Připojme soubor config.php:

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

Výsledek provedení kódu (pokud je v config.php definováno pole $config):

php'Můj web'

Příklad

Pokus o opakované připojení stejného souboru:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Toto volání bude ignorováno
  echo sum(2, 3);
?>

Výsledek provedení kódu:

php5

Rozdíl oproti require

Na rozdíl od require funkce require_once kontroluje, zda byl soubor již připojen, a neprovádí opakované připojení. Tím se zabrání chybám při vícenásobném připojení stejného souboru.

Viz také