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 ֆունկցիան,
որը երաշխավորում է ֆայլի միակ անգամ միացում