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

require_once 'path/to/file.php';

Przykład

Dołączmy plik config.php:

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

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

'My Site'

Przykład

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

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

Wynik wykonania kodu:

5

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

funkcję include,
która również dołącza pliki, ale nie sprawdza ich ponownego dołączenia
funkcję include_once,
która działa podobnie jak require_once, ale nie powoduje błędu krytycznego przy braku pliku