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

phpinclude_once 'path/to/file.php';

Primer

Vključimo datoteko config.php samo enkrat:

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

Primer

Poskus vključitve neobstoječe datoteke:

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

Rezultat izvajanja kode:

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

Primer

Uporaba spremenljivke za določitev poti:

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

Glejte tudi