Funkcija include_once

Funkcija include_once iekļauj norādīto failu pašreizējā PHP skriptā, bet tikai tad, ja tas nav bijis iekļauts iepriekš. Tas ir īpaši noderīgi, strādājot ar failiem, kas satur funkciju vai klašu deklarācijas, lai izvairītos no atkārtotas deklarācijas kļūdām. Funkcijas parametrā tiek padots ceļš uz iekļaujamo failu.

Sintakse

phpinclude_once 'path/to/file.php';

Piemērs

Iekļausim failu config.php tikai vienu reizi:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Šis izsaukums tiks ignorēts
?>

Piemērs

Mēģinājums iekļaut neesošu failu:

php<?php
  include_once 'nonexistent.php'; // Izraisīs brīdinājumu, bet neapstās skripta izpildi
  echo 'Script continues...';
?>

Koda izpildes rezultāts:

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

Piemērs

Mainīgā izmantošana ceļa norādīšanai:

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

Skatiet arī