Funcția include_once

Funcția include_once include fișierul specificat în scriptul PHP curent, dar numai dacă nu a fost deja inclus anterior. Acest lucru este util în special atunci când lucrați cu fișiere care conțin declarații de funcții sau clase, pentru a evita erorile de redeclarare. În parametrul funcției este transmisă calea către fișierul de inclus.

Sintaxă

include_once 'path/to/file.php';

Exemplu

Să includem fișierul config.php doar o singură dată:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Acest apel va fi ignorat
?>

Exemplu

Încercarea de a include un fișier inexistent:

<?php
	include_once 'nonexistent.php'; // Va genera un avertisment, dar nu va opri execuția scriptului
	echo 'Scriptul continuă...';
?>

Rezultatul executării codului:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Scriptul continuă...

Exemplu

Utilizarea unei variabile pentru a specifica calea:

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

Vedeți și

funcția include,
care include fișierul fără verificarea pentru includere repetată
funcția require,
care include fișierul cu oprirea scriptului în caz de eroare
funcția require_once,
care funcționează ca include_once, dar oprește scriptul în caz de eroare