ფუნქცია 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,
რომელიც გარანტიას იძლევა ფაილის ერთჯერადი შეერთების