Funktsioon require_once

Funktsioon require_once ühendab määratud faili praegusse skripti. Kui fail on juba varem ühendatud, ei ühenda funktsioon seda uuesti. See on eriti kasulik klasside või funktsioonide failide ühendamiseks, kus korduv ühendamine võib põhjustada vigu.

Süntaks

phprequire_once 'path/to/file.php';

Näide

Ühendame faili config.php:

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

Koodi täitmise tulemus (kui config.php-s on määratud massiiv $config):

php'Minu Sait'

Näide

Sama faili korduva ühendamise katse:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // See kutse ignoreeritakse
  echo sum(2, 3);
?>

Koodi täitmise tulemus:

php5

Erinevus require-st

Erinevalt require-st, funktsioon require_once kontrollib, kas fail on juba ühendatud, ja ei täida korduvat ühendamist. See hoiab ära vead, mis tekivad sama faili mitmekordsel kaasamisel.

Vaata ka

  • funktsiooni include,
    mis samuti ühendab faile, kuid ei kontrolli nende korduvat kaasamist
  • funktsiooni include_once,
    mis töötab sarnaselt require_once'ga, kuid ei põhjusta fatal errorit kui faili pole olemas