PHPinclude_onceステートメント

はじめに

includeステートメントと同様に、include_onceは、あるファイルに書き込まれたスクリプトを別のファイルに転送して評価します。2つの違いは、include_onceが、同じファイルが既に実行されている場合に再ロードを防ぐという事実にあります。名前が示すように、インクルード命令を再度発行しようとしても、ファイルは1回だけインクルードされます。

include_onceステートメントは通常、グローバル変数を設定したり、ライブラリを有効にしたり、アプリケーションの実行の開始時に実行されることが予想されるそのようなアクティビティを有効にしたりするために使用されます。

これを除けば、include_onceステートメントの動作はincludeステートメントに似ています。

include_onceの例

次の例では、testscript.phpがApacheサーバーのドキュメントルートフォルダーにあります。 include_onceステートメントを使用してtest.phpを挿入します

例

<?php
echo "calling include_once statement\n";
$result=include_once "test.php";
?>
//test.php
<?php
echo "This file is included once\n";
?>

出力

これにより、testscript.phpのURLが指定されている場合、ブラウザで次の結果が生成されます-

calling include_once statement

このファイルは一度含まれます

失敗した場合の警告

include_onceステートメントのファイル引数が見つからない場合、パーサーによって警告が発行されます

例

<?php
echo "inside main script<br />";
$var1=100;
echo "now calling nosuchfile.php script";
include_once "nosuchfile.php";
echo "returns from nosuchfile.php";
?>

出力

これにより、次の結果が得られます。プログラムは警告で終わらないことに注意してください-

inside main script
now calling nosuchfile.php script
PHP Warning: include_once(nosuchfile.php): failed to open stream: No such file or directory in line 5
PHP Warning: include_once(): Failed opening 'nosuchfile.php' for inclusion (include_path='C:\xampp\php\PEAR') in line 5
returns from nosuchfile.php

include_onceが再度呼び出されました

次の例には、include_onceステートメントを含むtest.phpが含まれています。同じファイルが再度含まれないことに注意してください

例

//main script
<?php
echo "inside main script<br>";
echo "now including test.php script<br>";
include_once "test.php";
echo "now including again test.php script<br>";
?>
//test.php included
<?php
echo "This file is included once";
?>

出力

これにより、ブラウザで次の結果が生成されます-

inside main script<br />now including test.php script<br />

このファイルは一度含まれます

test.phpスクリプトが再び含まれるようになりました