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ă

phpinclude_once 'path/to/file.php';

Exemplu

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

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

Exemplu

Încercarea de a include un fișier inexistent:

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

Rezultatul executării codului:

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

Exemplu

Utilizarea unei variabile pentru a specifica calea:

php<?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