PHP include_once

PHP の include_once 関数は、スクリプトの実行中に特定のファイルの操作を構成して実行します。したがって、これは PHP の include ステートメントと同じです。唯一の変更点は、別のファイルのスクリプトがすでに存在する場合、そのスクリプトは再度インクルードされず、この関数 include_once は TRUE のみを返すことです。したがって、名前自体が示すように、ここにあるファイルは一度だけインクルードされます。

無料ソフトウェア開発コースを始めましょう

Web 開発、プログラミング言語、ソフトウェア テスト、その他

include_once は基本的に、スクリプトの実行中に単一のファイルを囲んで複数回操作できる場所で使用されます。これにより、変数値の再割り当て、関数の再定義などのさまざまな問題を防ぐことができます。この関数も、require_once 関数とよく似ています。

構文:

include_once('file name with its full path');

上の構文は一目瞭然です。

PHP include_once 関数の例

コード内に、ファイル p とファイル q のような 2 つの異なるファイルが必要であると考えてみましょう。以下の状態を確認してください:

p: m を含む、n を含む

m: n を含む

n: 「これは関数 a です」をエコーし​​ます

ここでは関数 p を実行し、最初に関数 m と n が含まれているとします。以下でわかるように、関数 m は n も呼び出すため、それが含まれます。これにより、n が 2 回含まれることになり、これはかなり不適切であることがわかります。したがって、include_once 関数を使用すると、その呼び出しを 1 回のみに制限できます。

したがって、include_once は、2 つのモデルがあり、そのうちの 1 つがデータベース接続モデルを呼び出す必要があると仮定する場合に適用できます。こちらも含め、毎回重複エラーが発生する場合がございます。したがって、include_once を使用すると、一度だけインクルードすることを意図したものと同じことを回避できます。

PHP include_once の例

以下に例を示します:

例 #1

コード:

<?php
// First file displaying present date
echo "Finding the current date here \n";
echo "today is:".date("Y-m-d");
?>

これは、次のコード部分で呼び出す「Main.php」という名前で保存する最初のファイルです。

<?php
include_once('Main.php');
include_once('Main.php');
?>

出力:

上記のコードでは、include_once 関数を使用して Main.php ファイルを 2 回インクルードしています。ただし、出力でわかるように、呼び出された 2 番目のインスタンスは無視されるため、エコー表示データは 1 回しか取得されません。これは、 include_once() 関数が実行後の最初のものと同じすべての包含を無視するためです。

例 #2

以下のように、実行するファイルが 3 つあるとします。

FIRST_FUNCTION.php
SECOND_FUNCTION.php
THIRD_FUNCTION.php

FIRST_FUNCTION.php のコードは次のようになります:

<?php
// declaring a function
function func(){
echo 'first function called';
}
?>

SECOND_FUNCTION.php:

<?php
// using include function to include the above function
include('FIRST_FUNCTION.PHP');
echo 'second function called';
func();
?>

THIRD_FUNCTION.php

<?php
include('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
func();
?>

この THIRD_FUNCTION.php を実行すると、SECOND_FUNCTION.php ファイルにすでに FIRST_FUNCTION.php が含まれているため、エラーが発生します。エラーは、関数 func() がすでに SECOND_FUNCTION.php で宣言されており、すでに THIRD_FUNCTION.php にインクルードされていることを示します。これは、すでに FIRST_FUNCTION.php を 2 回インクルードしていることを意味します。したがって、FIRST_FUNCTION.php を一度だけ使用するようにするには、include_once() 関数を使用して、THIRD_FUNCTION.php を以下のようなものに変更する必要があります。

<?php
// using include_once function
include_once('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
?>

出力:

このコードを実行すると、エラーは発生しません。これは、PHP がエラーのスローを避けるために FIRST_FUNCTION.php を 1 回だけインクルードするためです。したがって、そのような場合は、PHP コードで include() 関数の代わりに include_once() 関数を使用する必要があります。

PHP の include 関数は require 関数に非常に似ていますが、これらの間にはいくつかの相違点があり、次のとおりです。

• include 関数はエラーが発生するたびに警告 (E_WARNING) をスローしますが、require 関数はそうではありません。
• 関数の組み込み中にエラーが発生した後でもスクリプトの実行は続行されますが、必要な関数の実行中にエラー (E_COMPILE_ERROR) が発生すると実行が停止します。
• 例: require ステートメントは、フローにキー ファイルを含める必要がある CMS、フレームワーク、または PHP 関数コーディングの場合に実行するために使用できます。これは、キー ファイルの 1 つが存在しない場合にアプリケーションの整合性とセキュリティを維持するのに役立ちます。
• 同様に、このファイルをインクルードすると、すべての Web ページの標準フッター、ヘッダー、またはメニュー ファイルをいつでも作成してインクルードできるため、時間を大幅に節約できます。そうすれば、必要なときにヘッダー ファイルのみを更新できます。

PHP include_once を使用する利点

• この include_once は、特定のファイルが見つからない場合に致命的なエラーではなく警告をスローするため、実行は中断されず、スムーズに続行されます。
• 一部の関数や変数を再利用する必要がある場合の処理​​に最適です。
• 変数値の再割り当て、特定の関数の再定義などの問題を回避するのに役立ちます。
• 特定の関数を定期的に呼び出す必要がある場合に便利です。

結論

PHP include Once は、スクリプトをインクルードし、スクリプトが 1 回だけ実行されるようにするために使用され、同じスクリプトの重複呼び出しによって発生する可能性のあるエラーを防ぎます。これは基本的に、コードの実行に必要なあらゆる種類の宣言または構成ファイルに共通のコード部分を使用する必要がある場合に使用されます。

以上がPHP include_onceの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。