Funktionen include_once

Funktionen include_once tilføjer den specificerede fil til det nuværende PHP-script, men kun hvis den ikke er blevet tilføjet tidligere. Dette er især nyttigt ved arbejde med filer, der indeholder erklæringer af funktioner eller klasser, for at undgå fejl ved gentagen erklæring. Til funktionens parameter overføres stien til den fil, der skal tilføjes.

Syntaks

phpinclude_once 'path/to/file.php';

Eksempel

Lad os tilføje filen config.php kun én gang:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Dette kald vil blive ignoreret
?>

Eksempel

Forsøg på at tilføje en ikke-eksisterende fil:

php<?php
  include_once 'nonexistent.php'; // Vil forårsage en advarsel, men stopper ikke scriptets udførelse
  echo 'Scriptet fortsætter...';
?>

Resultat af kodeudførelse:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Scriptet fortsætter...

Eksempel

Brug af variabel til at angive sti:

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

Se også

  • funktionen include,
    som tilføjer en fil uden kontrol for gentagen inkludering
  • funktionen require,
    som tilføjer en fil med stop af scriptet ved fejl
  • funktionen require_once,
    som fungerer som include_once, men stopper scriptet ved fejl