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

phpinclude_once 'path/to/file.php';

Przykład

Dołączmy plik config.php tylko raz:

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

Przykład

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

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

Wynik wykonania kodu:

phpWarning: 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<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

Zobacz też