Функцыя require

Функцыя require падключае і выконвае паказаны файл у бягучым скрыпце. У адрозненне ад include, пры адсутнасці файла выклікае фатальную памылку і спыняе выкананне скрыпта. Функцыя часта выкарыстоўваецца для падключэння важных файлаў з функцыямі, класамі або наладамі.

Сінтаксіс

require 'path/to/file.php';

Прыклад

Падключэнне файла з наладамі:

<?php
	require 'config.php';
	echo $db_host; // Пераменная з config.php
?>

Калі файл config.php існуе, яго змест будзе выкананы, і пераменныя стануць даступныя.

Прыклад

Спроба падключыць неіснуючы файл:

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

Калі файл missing_file.php не існуе, скрыпт скончыцца з памылкай.

Розніца паміж require і include

Асноўная адрознасць - require выклікае фатальную памылку пры адсутнасці файла, тады як include толькі папярэджанне.

<?php
	include 'optional_file.php'; // Скрыпт працягне працу
	require 'required_file.php'; // Скрыпт спыніцца пры памылцы
?>

Глядзіце таксама

функцыю include,
якая таксама падключае файлы, але не спыняе скрыпт пры памылцы
функцыю require_once,
якая гарантуе аднакратнае падключэнне файла