include_once funksiyası

include_once funksiyası göstərilən faylı cari PHP skriptinə birləşdirir, lakin yalnız əgər əvvəl birləşdirilməmişdisə. Bu, xüsusilə funksiyaların və ya siniflərin bəyanlarını ehtiva edən faylarla işləyərkən, təkrar bəyan səhvlərinin qarşısını almaq üçün faydalıdır. Funksiyanın parametrinə birləşdiriləcək faylın yolu ötürülür.

Sintaksis

phpinclude_once 'path/to/file.php';

Nümunə

Gəlin config.php faylını yalnız bir dəfə birləşdirək:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Bu çağırış laqeyd ediləcək
?>

Nümunə

Mövcud olmayan faylı birləşdirmək cəhdi:

php<?php
  include_once 'nonexistent.php'; // Xəbərdarlığa səbəb olacaq, lakin skriptin icrasını dayandırmayacaq
  echo 'Skript davam edir...';
?>

Kodun icrasının nəticəsi:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Nümunə

Yolu göstərmək üçün dəyişəndən istifadə:

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

Həmçinin baxın

  • include funksiyası,
    təkrar daxil etmə yoxlaması olmadan faylı birləşdirir
  • require funksiyası,
    səhv zamanı skripti dayandıraraq faylı birləşdirir
  • require_once funksiyası,
    include_once kimi işləyir, lakin səhv zamanı skripti dayandırır