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