Ֆունկցիա require_once

Ֆունկցիան require_once նշված ֆայլը միացնում է ընթացիկ սկրիպտին: Եթե ֆայլն արդեն միացված է եղել նախկինում, ֆունկցիան այն չի միացնի կրկին: Սա հատկապես օգտակար է դասեր կամ ֆունկցիաներ պարունակող ֆայլեր միացնելիս, որտեղ կրկնակի միացումը կարող է սխալների հանգեցնել:

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

phprequire_once 'path/to/file.php';

Օրինակ

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

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

Կոդի կատարման արդյունքը (եթե config.php-ում սահմանված է $config զանգված):

php'My Site'

Օրինակ

Նույն ֆայլի կրկնակի միացման փորձ.

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Այս կանչը կանտեսվի
  echo sum(2, 3);
?>

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

php5

Տարբերությունը require-ից

Ի տարբերություն require-ի, require_once ֆունկցիան ստուգում է, արդյոք ֆայլն արդեն միացված է, և չի կատարում կրկնակի միացում: Սա կանխում է սխալները նույն ֆայլի բազմակի ներառման դեպքում:

Տես նաև

  • include ֆունկցիան,
    որը նույնպես միացնում է ֆայլեր, բայց չի ստուգում դրանց կրկնակի ներառումը
  • include_once ֆունկցիան,
    որը գործում է նման require_once-ին, բայց չի առաջացնում ֆատալ սխալ, եթե ֆայլը բացակայում է