Fungsi require_once

Fungsi require_once menyambungkan fail yang dinyatakan ke dalam skrip semasa. Jika fail telah disambungkan sebelum ini, fungsi ini tidak akan menyambungkannya semula. Ini amat berguna untuk menyambungkan fail yang mengandungi kelas atau fungsi, di mana penyambungan semula boleh menyebabkan ralat.

Sintaks

require_once 'path/to/file.php';

Contoh

Mari sambungkan fail config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Keputusan pelaksanaan kod (jika dalam config.php tatasusunan $config ditakrifkan):

'My Site'

Contoh

Cubaan untuk menyambungkan semula fail yang sama:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Panggilan ini akan diabaikan
	echo sum(2, 3);
?>

Keputusan pelaksanaan kod:

5

Perbezaan dengan require

Berbeza dengan require, fungsi require_once menyemak sama ada fail telah disambungkan sebelum ini, dan tidak melaksanakan penyambungan semula. Ini mengelakkan ralat apabila fail yang sama disertakan beberapa kali.

Lihat juga

fungsi include,
yang juga menyambungkan fail, tetapi tidak menyemak penyertaan semula mereka
fungsi include_once,
yang berfungsi sama seperti require_once, tetapi tidak menyebabkan ralat fatal jika fail tiada