Funkcija require_once

Funkcija require_once prijungia nurodytą failą į esamą scenarijų. Jei failas jau buvo prijungtas anksčiau, funkcija jo vėl neprijungs. Tai ypač naudinga prijungiant failus su klasėmis ar funkcijomis, kur pakartotinis prijungimas gali sukelti klaidas.

Sintaksė

phprequire_once 'path/to/file.php';

Pavyzdys

Prijunkime failą config.php:

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

Kodo vykdymo rezultatas (jei config.php faile apibrėžtas masyvas $config):

php'Mano svetainė'

Pavyzdys

To paties failo pakartotinio prijungimo bandymas:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Šis kreipimasis bus ignoruojamas
  echo sum(2, 3);
?>

Kodo vykdymo rezultatas:

php5

Skirtumas nuo require

Skirtingai nuo require, funkcija require_once tikrina, ar failas jau buvo prijungtas, ir nevykdo pakartotinio prijungimo. Tai užkerta kelią klaidoms, kai tas pats failas įtraukiamas kelis kartus.

Taip pat žiūrėkite