Funkcija require

Funkcija require priključi in izvede določeno datoteko v trenutni skripti. Za razliko od include, pri odsotnosti datoteke povzroči fatalno napako in ustavi izvajanje skripte. Funkcija se pogosto uporablja za priključevanje pomembnih datotek s funkcijami, razredi ali nastavitvami.

Sintaksa

phprequire 'path/to/file.php';

Primer

Priključevanje datoteke z nastavitvami:

php<?php
  require 'config.php';
  echo $db_host; // Spremenljivka iz config.php
?>

Če datoteka config.php obstaja, bo njena vsebina izvedena in spremenljivke postanejo dostopne.

Primer

Poskus priključitve neobstoječe datoteke:

php<?php
  require 'missing_file.php';
  echo 'Ta vrstica se ne bo izvedla';
?>

Če datoteka missing_file.php ne obstaja, se bo skripta končala z napako.

Razlika med require in include

Glavna razlika je - require povzroči fatalno napako pri odsotnosti datoteke, medtem ko include le opozorilo.

php<?php
  include 'optional_file.php'; // Skripta bo nadaljevala z delom
  require 'required_file.php'; // Skripta se bo ustavila ob napaki
?>

Glejte tudi

  • funkcijo include,
    ki prav tako priključi datoteke, vendar ne ustavi skripte ob napaki
  • funkcijo require_once,
    ki zagotovi enkratno priključitev datoteke