Funkcija require_once

Funkcija require_once pievieno norādīto failu pašreizējā skriptā. Ja fails jau iepriekš bija pievienots, funkcija to vairs nepievienos. Tas ir īpaši noderīgi failu ar klasēm vai funkcijām pievienošanai, kur atkārtota pievienošana var izraisīt kļūdas.

Sintakse

phprequire_once 'path/to/file.php';

Piemērs

Pievienosim failu config.php:

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

Koda izpildes rezultāts (ja config.php ir definēts masīvs $config):

php'My Site'

Piemērs

Mēģinājums atkārtoti pievienot to pašu failu:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Šis izsaukums tiks ignorēts
  echo sum(2, 3);
?>

Koda izpildes rezultāts:

php5

Atšķirība no require

Atšķirībā no require, funkcija require_once pārbauda, vai fails jau ir pievienots, un neveic atkārtotu pievienošanu. Tas novērš kļūdas, vairākkārtēji iekļaujot vienu un to pašu failu.

Skatiet arī

  • funkciju include,
    kas arī pievieno failus, bet nepārbauda to atkārtotu iekļaušanu
  • funkciju include_once,
    kas strādā līdzīgi kā require_once, bet neizraisa fatālu kļūdu, ja fails nav atrasts