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

phprequire_once 'path/to/file.php';

Contoh

Mari sambungkan fail config.php:

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

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

php'My Site'

Contoh

Cubaan untuk menyambungkan semula fail yang sama:

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

Keputusan pelaksanaan kod:

php5

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