Funktsioon include_once

Funktsioon include_once lisab määratud faili praegusesse PHP skripti, kuid ainult juhul, kui seda pole varem kaasatud. See on eriti kasulik failidega, mis sisaldavad funktsioonide või klasside deklaratsioone, et vältida kordusdeklaratsiooni vigu. Funktsiooni parameetrina edastatakse tee kaasatavale failile.

Süntaks

phpinclude_once 'path/to/file.php';

Näide

Kaasame faili config.php ainult üks kord:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // See kutse ignoreeritakse
?>

Näide

Katse kaasada olematut faili:

php<?php
  include_once 'nonexistent.php'; // Tekitab hoiatus, kuid ei peata skripti täitmist
  echo 'Skript jätkub...';
?>

Koodi täitmise tulemus:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Näide

Muutuja kasutamine tee määramiseks:

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

Vaata ka