Funkcija include_once

Funkcija include_once prijungia nurodytą failą į esamą PHP scenarijų, bet tik jei jis nebuvo prijungtas anksčiau. Tai ypač naudinga dirbant su failais, kuriuose yra funkcijų ar klasių deklaracijos, kad būtų išvengta pakartotinio deklaravimo klaidų. Į funkcijos parametrą perduodamas kelias į prijungiamą failą.

Sintaksė

phpinclude_once 'path/to/file.php';

Pavyzdys

Prijungkime failą config.php tik vieną kartą:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Šis kreipimasis bus ignoruojamas
?>

Pavyzdys

Bandymas prijungti neegzistuojantį failą:

php<?php
  include_once 'nonexistent.php'; // Sukels įspėjimą, bet nestabdys scenarijaus vykdymo
  echo 'Scenarijus tęsiasi...';
?>

Kodo vykdymo rezultatas:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Scenarijus tęsiasi...

Pavyzdys

Kintamojo naudojimas kelio nurodymui:

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

Taip pat žiūrėkite