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