Funksie include_once

Die funksie include_once sluit die gespesifiseerde lêer in die huidige PHP-skrip in, maar slegs as dit nie vantevore ingesluit is nie. Dit is veral nuttig wanneer met lêers gewerk word wat funksie- of klasverklarings bevat, om foute van herhaalde verklaring te voorkom. Die pad na die in te sluit lêer word as parameter aan die funksie oorgedra.

Sintaksis

include_once 'pad/tot/lêer.php';

Voorbeeld

Laat ons die lêer config.php slegs een keer insluit:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Hierdie oproep sal geïgnoreer word
?>

Voorbeeld

'n Poging om 'n nie-bestaande lêer in te sluit:

<?php
	include_once 'nonexistent.php'; // Sal 'n waarskuwing veroorsaak, maar sal nie die skrip stop nie
	echo 'Skrip gaan voort...';
?>

Resultaat van die kode-uitvoering:

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

Voorbeeld

Gebruik van 'n veranderlike om die pad aan te dui:

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

Sien ook

die funksie include,
wat 'n lêer insluit sonder om vir herhaalde insluiting te kontroleer
die funksie require,
wat 'n lêer insluit en die skrip stop as daar 'n fout is
die funksie require_once,
wat soos include_once werk, maar die skrip stop as daar 'n fout is