Fungsi include_once

Fungsi include_once menyambungkan fail yang ditentukan ke dalam skrip PHP semasa, tetapi hanya jika ia belum disambungkan sebelum ini. Ini amat berguna apabila bekerja dengan fail yang mengandungi pengisytiharan fungsi atau kelas untuk mengelakkan ralat pengisytiharan semula. Laluan ke fail yang disambungkan diteruskan ke dalam parameter fungsi.

Sintaks

phpinclude_once 'path/to/file.php';

Contoh

Sambungkan fail config.php hanya sekali:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Panggilan ini akan diabaikan
?>

Contoh

Cuba sambungkan fail yang tidak wujud:

php<?php
  include_once 'nonexistent.php'; // Akan menyebabkan amaran, tetapi tidak menghentikan pelaksanaan skrip
  echo 'Skrip diteruskan...';
?>

Keputusan pelaksanaan kod:

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

Contoh

Menggunakan pembolehubah untuk menentukan laluan:

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

Lihat juga

  • fungsi include,
    yang menyambungkan fail tanpa semakan untuk penyertaan semula
  • fungsi require,
    yang menyambungkan fail dengan penghentian skrip jika berlaku ralat
  • fungsi require_once,
    yang berfungsi seperti include_once, tetapi menghentikan skrip jika berlaku ralat