Funkcija include_once

Funkcija include_once prijungia nurodytą failą į esamą PHP scenarijų, bet tik jei jis nebuvo prijungtas anksčiau. Tai ypač naudinga dirbant su failais, kuriuose yra funkcijų ar klasių deklaracijos, kad būtų išvengta pakartotinio deklaravimo klaidų. Į funkcijos parametrą perduodamas kelias į prijungiamą failą.

Sintaksė

include_once 'path/to/file.php';

Pavyzdys

Prijungkime failą config.php tik vieną kartą:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Šis kreipimasis bus ignoruojamas
?>

Pavyzdys

Bandymas prijungti neegzistuojantį failą:

<?php
	include_once 'nonexistent.php'; // Sukels įspėjimą, bet nestabdys scenarijaus vykdymo
	echo 'Scenarijus tęsiasi...';
?>

Kodo vykdymo rezultatas:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Scenarijus tęsiasi...

Pavyzdys

Kintamojo naudojimas kelio nurodymui:

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

Taip pat žiūrėkite

funkciją include,
kuri prijungia failą be patikrinimo ar jis jau prijungtas
funkciją require,
kuri prijungia failą su scenarijaus sustabdymu klaidos atveju
funkciją require_once,
kuri veikia kaip include_once, bet sustabdo scenarijų klaidos atveju