Fungsi require

Fungsi require menyambung dan melaksanakan fail yang ditentukan dalam skrip semasa. Berbeza dengan include, jika fail tiada, ia menyebabkan ralat fatal dan menghentikan pelaksanaan skrip. Fungsi ini sering digunakan untuk menyambung fail penting dengan fungsi, kelas atau tetapan.

Sintaks

require 'path/to/file.php';

Contoh

Sambungan fail dengan tetapan:

<?php
	require 'config.php';
	echo $db_host; // Pemboleh ubah dari config.php
?>

Jika fail config.php wujud, kandungannya akan dilaksanakan, dan pemboleh ubah akan boleh diakses.

Contoh

Cuba menyambung fail yang tidak wujud:

<?php
	require 'missing_file.php';
	echo 'This line will not execute';
?>

Jika fail missing_file.php tidak wujud, skrip akan tamat dengan ralat.

Perbezaan antara require dan include

Perbezaan utama - require menyebabkan ralat fatal jika fail tiada, manakala include hanya amaran.

<?php
	include 'optional_file.php'; // Skrip akan terus berfungsi
	require 'required_file.php'; // Skrip akan berhenti jika ralat
?>

Lihat juga

fungsi include,
yang juga menyambung fail, tetapi tidak menghentikan skrip jika ralat
fungsi require_once,
yang menjamin sambungan fail sekali sahaja