Funkcija include_once

Funkcija include_once vključi navedeno datoteko v trenutno PHP skripto, vendar le, če še ni bila vključena prej. To je še posebej uporabno pri delu z datotekami, ki vsebujejo deklaracije funkcij ali razredov, da se prepreči napake ponovne deklaracije. V parameter funkcije se posreduje pot do datoteke, ki jo želimo vključiti.

Sintaksa

include_once 'path/to/file.php';

Primer

Vključimo datoteko config.php samo enkrat:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Ta klic bo prezrt
?>

Primer

Poskus vključitve neobstoječe datoteke:

<?php
	include_once 'nonexistent.php'; // Povzroči opozorilo, vendar ne ustavi izvajanja skripte
	echo 'Script continues...';
?>

Rezultat izvajanja kode:

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

Primer

Uporaba spremenljivke za določitev poti:

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

Glejte tudi

funkcijo include,
ki vključi datoteko brez preverjanja za ponovno vključitev
funkcijo require,
ki vključi datoteko z zaustavitvijo skripte ob napaki
funkcijo require_once,
ki deluje kot include_once, vendar ustavi skripto ob napaki