Funkcja include_once

Funkcja include_once dołącza określony plik do bieżącego skryptu PHP, ale tylko jeśli nie został on dołączony wcześniej. Jest to szczególnie przydatne podczas pracy z plikami zawierającymi deklaracje funkcji lub klas, aby uniknąć błędów ponownej deklaracji. Do parametru funkcji przekazywana jest ścieżka do pliku, który ma zostać dołączony.

Składnia

include_once 'path/to/file.php';

Przykład

Dołączmy plik config.php tylko raz:

<?php
	include_once 'config.php';
	include_once 'config.php'; // To wywołanie zostanie zignorowane
?>

Przykład

Próba dołączenia nieistniejącego pliku:

<?php
	include_once 'nonexistent.php'; // Spowoduje ostrzeżenie, ale nie zatrzyma wykonania skryptu
	echo 'Skrypt kontynuuje działanie...';
?>

Wynik wykonania kodu:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Skrypt kontynuuje działanie...

Przykład

Użycie zmiennej do określenia ścieżki:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Zobacz też

funkcję include,
która dołącza plik bez sprawdzania ponownego dołączenia
funkcję require,
która dołącza plik z zatrzymaniem skryptu w przypadku błędu
funkcję require_once,
która działa jak include_once, ale zatrzymuje skrypt w przypadku błędu