制御構造
PHP Manual

include_once()

include_once()命令は、スクリプトの実行時に指定 したファイルを読み込み評価します。この動作は、 include()命令と似ていますが、ファイルからのコー ドが既に読み込まれている場合は、再度読み込まれないという重要な違い があります。その名が示す通り、ファイルは一度しか読み込まれません。

include_once()は、スクリプトの実行時に同じファイ ルが複数回読み込まれ、評価される可能性がある場合に、関数の再定義や 変数値の再代入といった問題を回避するために一回だけ読み込ませるため に使用します。

require_once()および include_once()の使用例に関する他の例については、 最新のPHPソースコード配布ファイルに含まれる » PEARのコードを参照ください。

返り値は include() と同じです。 ファイルが既に読み込まれている場合は、この関数は TRUE を返します。

注意: include_once() は、PHP 4.0.1で追加されました。

注意: (Windowsのように)大文字小文字を区別しないオペレーティングシステムでは、 include_once()および require_once()の動作が意図したものにならない 可能性があるので注意してください。

例1 include_once() はWindowsでは大文字小文字を区別しません

<?php
include_once "a.php"// a.phpを読み込みます
include_once "A.php"// Windowsはこれもa.phpを読み込みます! (PHP 4 のみ)
?>

この挙動は PHP 5 で変更されました。まず最初にパスが正規化されるので、 C:\PROGRA~1\A.phpC:\Program Files\a.php と同じ扱いとなります。 ファイルは一度だけ読み込まれるようになります。

警告

PHP 4.3.0 より前のバージョンの Windows 版 PHP は、現在この関数に関してリモートファイルアクセス機能を サポートしていません。これは、allow_url_fopen を 有効にした場合でも同様です。

include(), require(), require_once(), get_required_files(), get_included_files(), readfile(), および virtual() も参照ください。


制御構造
PHP Manual