Fungsi include_once

Fungsi include_once menyambungkan fail yang ditentukan ke dalam skrip PHP semasa, tetapi hanya jika ia belum disambungkan sebelum ini. Ini amat berguna apabila bekerja dengan fail yang mengandungi pengisytiharan fungsi atau kelas untuk mengelakkan ralat pengisytiharan semula. Laluan ke fail yang disambungkan diteruskan ke dalam parameter fungsi.

Sintaks

include_once 'path/to/file.php';

Contoh

Sambungkan fail config.php hanya sekali:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Panggilan ini akan diabaikan
?>

Contoh

Cuba sambungkan fail yang tidak wujud:

<?php
	include_once 'nonexistent.php'; // Akan menyebabkan amaran, tetapi tidak menghentikan pelaksanaan skrip
	echo 'Skrip diteruskan...';
?>

Keputusan pelaksanaan kod:

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

Contoh

Menggunakan pembolehubah untuk menentukan laluan:

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

Lihat juga

fungsi include,
yang menyambungkan fail tanpa semakan untuk penyertaan semula
fungsi require,
yang menyambungkan fail dengan penghentian skrip jika berlaku ralat
fungsi require_once,
yang berfungsi seperti include_once, tetapi menghentikan skrip jika berlaku ralat