Funkcija require

Funkcija require prijungia ir vykdo nurodytą failą esamame scenarijuje. Skirtingai nei include, jei failas nerandamas, iššaukia fatalią klaidą ir sustabdo scenarijaus vykdymą. Funkcija dažnai naudojama svarbių failų su funkcijomis, klasėmis ar nustatymais prijungimui.

Sintaksė

require 'path/to/file.php';

Pavyzdys

Failo su nustatymais prijungimas:

<?php
	require 'config.php';
	echo $db_host; // Kintamasis iš config.php
?>

Jei failas config.php egzistuoja, jo turinys bus vykdomas, ir kintamieji taps prieinami.

Pavyzdys

Bandymas prijungti neegzistuojantį failą:

<?php
	require 'missing_file.php';
	echo 'Ši eilutė nebus vykdoma';
?>

Jei failas missing_file.php neegzistuoja, scenarijus bus nutrauktas su klaida.

Skirtumas tarp require ir include

Pagrindinis skirtumas - require iššaukia fatalią klaidą jei failas nerandamas, tuo tarpu include tik įspėjimą.

<?php
	include 'optional_file.php'; // Scenarijus tęsias darbą
	require 'required_file.php'; // Scenarijus sustos klaidos atveju
?>

Taip pat žiūrėkite

funkciją include,
kuri taip pat prijungia failus, bet nestabdo scenarijaus klaidos atveju
funkciją require_once,
kuri garantuoja vienkartį failo prijungimą