Funkcja require_once

Funkcja require_once dołącza wskazany plik do bieżącego skryptu. Jeśli plik został już wcześniej dołączony, funkcja nie dołączy go ponownie. Jest to szczególnie przydatne przy dołączaniu plików z klasami lub funkcjami, gdzie ponowne dołączenie może spowodować błędy.

Składnia

phprequire_once 'path/to/file.php';

Przykład

Dołączmy plik config.php:

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

Wynik wykonania kodu (jeśli w config.php zdefiniowano tablicę $config):

php'My Site'

Przykład

Próba ponownego dołączenia tego samego pliku:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // To wywołanie zostanie zignorowane
  echo sum(2, 3);
?>

Wynik wykonania kodu:

php5

Różnica w stosunku do require

W przeciwieństwie do require, funkcja require_once sprawdza, czy plik został już dołączony i nie wykonuje ponownego dołączenia. Zapobiega to błędom przy wielokrotnym dołączaniu tego samego pliku.

Zobacz także