Funkcia require_once

Funkcia require_once pripojí zadaný súbor do aktuálneho skriptu. Ak bol súbor už predtým pripojený, funkcia ho nebude pripájať znova. Je to obzvlášť užitočné pre pripájanie súborov s triedami alebo funkciami, kde opakované pripojenie môže spôsobiť chyby.

Syntax

phprequire_once 'path/to/file.php';

Príklad

Pripájame súbor config.php:

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

Výsledok vykonania kódu (ak je v config.php definované pole $config):

php'My Site'

Príklad

Pokus o opakované pripojenie toho istého súboru:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Toto volanie bude ignorované
  echo sum(2, 3);
?>

Výsledok vykonania kódu:

php5

Rozdiel oproti require

Na rozdiel od require, funkcia require_once kontroluje, či bol súbor už pripojený, a nevykonáva opakované pripojenie. Toto zabraňuje chybám pri viacnásobnom zahrnutí toho istého súboru.

Pozri tiež

  • funkciu include,
    ktorá tiež pripája súbory, ale nekontroluje ich opakované zahrnutie
  • funkciu include_once,
    ktorá funguje podobne ako require_once, ale nespôsobí fatálnu chybu pri neprítomnosti súboru