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

phprequire 'path/to/file.php';

Contoh

Sambungan fail dengan tetapan:

php<?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<?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<?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