Функцыя 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, але спыняе скрыпт пры памылцы