Ֆունկցիա include_once

Ֆունկցիա include_once-ը միացնում է նշված ֆայլը ընթացիկ PHP սկրիպտին, բայց միայն այն դեպքում, եթե այն նախկինում չի միացվել: Սա հատկապես օգտակար է ֆունկցիաների կամ դասերի հայտարարումներ պարունակող ֆայլերի հետ աշխատելիս՝ կրկնակի հայտարարման սխալներից խուսափելու համար: Ֆունկցիայի պարամետրին փոխանցվում է միացվող ֆայլի ուղին:

Շարահյուսություն

phpinclude_once 'path/to/file.php';

Օրինակ

Միացնենք config.php ֆայլը միայն մեկ անգամ:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Այս կանչը կանտեսվի
?>

Օրինակ

Գոյություն չունեցող ֆայլ միացնելու փորձ.

php<?php
  include_once 'nonexistent.php'; // Կառաջացնի նախազգուշացում, բայց չի դադարեցնի սկրիպտի կատարումը
  echo 'Script continues...';
?>

Կոդի կատարման արդյունք.

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Օրինակ

Փոփոխականի օգտագործումը ուղին նշելու համար.

php<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

Տես նաև

  • ֆունկցիա include,
    որը միացնում է ֆայլը առանց կրկնակի ներառման ստուգման
  • ֆունկցիա require,
    որը միացնում է ֆայլը՝ դադարեցնելով սկրիպտի կատարումը սխալի դեպքում
  • ֆունկցիա require_once,
    որը աշխատում է ինչպես include_once-ը, բայց դադարեցնում է սկրիպտը սխալի դեպքում