Funkcija require_once

Funkcija require_once priključi navedeno datoteko v trenutno skripto. Če je bila datoteka že prej priključena, je funkcija ne bo priključila znova. To je še posebej uporabno za priključevanje datotek z razredi ali funkcijami, kjer lahko ponovno priključitev povzroči napake.

Sintaksa

phprequire_once 'path/to/file.php';

Primer

Priključimo datoteko config.php:

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

Rezultat izvajanja kode (če je v config.php definiran array $config):

php'My Site'

Primer

Poskus ponovnega priključevanja iste datoteke:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Ta klic bo ignoriran
  echo sum(2, 3);
?>

Rezultat izvajanja kode:

php5

Razlika od require

Za razliko od require, funkcija require_once preveri, ali je bila datoteka že priključena, in ne izvede ponovnega priključevanja. To prepreči napake pri večkratnem vključevanju iste datoteke.

Glejte tudi

  • funkcijo include,
    ki prav tako priključuje datoteke, vendar ne preverja njihovega ponovnega vključevanja
  • funkcijo include_once,
    ki deluje podobno kot require_once, vendar ne povzroči fatalne napake, če datoteka ni najdena