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

require 'path/to/file.php';

Piemērs

Iestatījumu faila pievienošana:

<?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
	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
	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