Funkcija require

Funkcija require pievieno un izpilda norādīto failu pašreizējā skriptā. Atšķirībā no include, ja fails nav atrodams, izraisa fatālu kļūdu un aptur skripta izpildi. Funkcija bieži tiek izmantota svarīgu failu ar funkcijām, klasēm vai iestatījumiem pievienošanai.

Sintakse

phprequire 'path/to/file.php';

Piemērs

Iestatījumu faila pievienošana:

php<?php
  require 'config.php';
  echo $db_host; // Mainīgais no config.php
?>

Ja fails config.php pastāv, tā saturs tiks izpildīts un mainīgie kļūs pieejami.

Piemērs

Mēģinājums pievienot neesošu failu:

php<?php
  require 'missing_file.php';
  echo 'This line will not execute';
?>

Ja fails missing_file.php neeksistē, skripts beigsies ar kļūdu.

Atšķirība starp require un include

Galvenā atšķirība - require izraisa fatālu kļūdu, ja fails nav atrodams, savukārt include tikai brīdinājumu.

php<?php
  include 'optional_file.php'; // Skripts turpinās darboties
  require 'required_file.php'; // Skripts apstāsies pie kļūdas
?>

Skatiet arī

  • funkciju include,
    kas arī pievieno failus, bet neaptur skriptu pie kļūdas
  • funkciju require_once,
    kas garantē vienreizēju faila pievienošanu