Az include_once függvény

Az include_once függvény a megadott fájlt behúzza az aktuális PHP szkriptbe, de csak akkor, ha azt korábban még nem húzták be. Ez különösen hasznos olyan fájlok esetén, amelyek függvény- vagy osztálydeklarációkat tartalmaznak, hogy elkerüljük az ismétlődő deklarálási hibákat. A függvény paramétereként a behúzandó fájl elérési útját adjuk meg.

Szintaxis

phpinclude_once 'path/to/file.php';

Példa

A config.php fájl behúzása csak egyszer:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Ez a hívás figyelmen kívül marad
?>

Példa

Megpróbálunk egy nem létező fájlt behúzni:

php<?php
  include_once 'nonexistent.php'; // Figyelmeztetést generál, de nem állítja le a szkript végrehajtását
  echo 'A szkript folytatódik...';
?>

A kód végrehajtásának eredménye:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
A szkript folytatódik...

Példa

Változó használata az elérési út megadásához:

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

Lásd még