Функцыя require

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

Сінтаксіс

phprequire 'path/to/file.php';

Прыклад

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

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

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

Прыклад

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

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

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

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

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

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

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

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