関数 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 'スクリプトは継続します...';
?>

コード実行結果:

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;
?>

関連項目