Функция 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, но спира скрипта при грешка