PHP include_once()、require_once()の使い分け解説
include_once()とrequire_once()は、PHP関数の2つであり、これらは現在のスクリプトに別のファイルを含め、実行し、尚且つ1度しか含まれないようにするものです。
include_once()はファイルをインクルードしますが、このファイルが既にインクルードされている場合は再度インクルードしません。ファイルがない場合、またはインクルードできなかった場合、include_once()は警告を発生させますが、スクリプトの実行は続行されます。
require_once()関数は include_once() と同じ働きをします。しかし、require_once() 関数は、ファイルが存在しないか、インクルードに失敗した場合に致命的なエラーを起こし、スクリプトの実行が停止します。
以下の例は include_once() 関数を使用する例です。
<?php
include_once 'header.php';
?>
<body>
<h1>Welcome to my website!</h1>
</body>
<?php
include_once 'footer.php';
?>
上記の例では、我々が現在使用しているスクリプトにそれぞれheader.phpとfooter.phpというファイルを含んでいます。これらのファイルにはHTMLコード、PHPコードやその他の有益なコードを含めることができます。もしこれらのファイルがすでに含められている場合、それらはもう1度包含されることはありません。
require_once() 関数の使用例を以下に示します。
<?php
require_once 'config.php';
?>
<body>
<h1>Welcome to my website!</h1>
</body>
上記の例では、require_once() 関数を使用して config.php ファイルを含みました。ファイルが存在しない、または含めることができない場合、スクリプトはすぐに実行を停止し、致命的なエラーを表示します。
まとめ
- include_once() と require_once() 関数を使用して、別のファイルをインクルードして実行します。
- include_once()関数は、ファイルを取り込む前に、既に取り込まれているかどうかを確認し、既に取り込まれている場合は取り込まれません。
- require_once()関数はinclude_once()と同様の挙動を示しますが、インクルードに失敗すると致命的なエラーを発生させます。