require()、include()、require_once()、および include_once() の類似点と相違点-php手册-php.cn

require() と include() には多くの類似点がありますが、相違点もいくつかあります。それらの違いを理解することが重要です。理解していないと間違いを犯しやすくなります。

読者が比較して学べるように、これら 2 つの文をまとめて紹介します。
1.require() ステートメント
require() ステートメントは、C 言語の include() ステートメントと同様に、ステートメント自体ではなくファイルを指定するために使用されます。 PHP 構成ファイル php.ini 内の URL fopen ラッパーがオンになっている場合 (デフォルトでオンになっています)、URL を使用してファイルの場所を指定し、リモートファイル呼び出しを行うことができます。
1 つは、require() ステートメントと include() ステートメントを使用するときに特別な注意を払うことです。つまり、インクルードされたファイルでは、プロセッサは HTML モードに従ってコンテンツを解釈し、インクルードされたコンテンツを処理した後、PHP モードに戻ります。したがって、インクルードされたファイルで PHP 構文を使用する必要がある場合は、正しい PHP 開始タグと終了タグを使用してこれらのステートメントをインクルードする必要があります。
require() と include() は PHP の言語機能であり、関数ではありません。これらは多くの点で関数とは異なります。
例: require() に含まれるファイルには制御構造を含めることはできず、return などのステートメントは使用できません。 require() に含まれるファイルで return ステートメントを使用すると、処理エラーが発生します。
include() ステートメントとは異なり、require() ステートメントは、これらのステートメントが実行されるかどうかに関係なく、含まれるファイルの内容を無条件に読み取ります。したがって、異なる条件に従って異なるファイルをインクルードする場合は、include() ステートメントを使用する必要があります。もちろん、require() の位置にあるステートメントが実行されない場合、require() に含まれるファイル内のステートメントも実行されません。
require() は、ループ本体内の異なる条件に応じて異なるファイルを含めることはできません。 require() ステートメントは、ステートメント自体を置き換えるために初めて実行されるときにのみ、ステートメントに含まれるファイルの内容を呼び出します。再度実行されるときは、最初に含まれるステートメントのみが実行されます。ただし、 include() ステートメントでは、ループ本体にさまざまなファイルを含めることができます。
require() ステートメント内の変数は、require() ステートメントが配置されている変数スコープを継承します。 require() ステートメントの場所でアクセスできるすべての変数は、require() ステートメントに含まれるファイル内でアクセスできます。 require() ステートメントが関数内にある場合、インクルードされたファイル内のステートメントは関数内で定義されているものと同等になります。
require() ステートメントは、PHP プログラムが実行される前に require によって参照されるファイルを読み取るため、通常、require はプログラムの先頭に置かれます。したがって、require ステートメントは少し強力であるという事実に特別な注意を払う必要があります。プログラムが参照ファイルを本当に必要とするかどうかに関係なく、require ステートメントを使用する限り、参照ファイルが含まれてしまいます。この関数を使用して条件制御ステートメントにインクルードすると、条件が true でなくても、参照されたファイルがインクルードされます。ゾンビが形成されると、操作中に目に見える影響はありませんが、明らかに負担が増加しますので、特に注意してください。 require ステートメントを使用してインクルードエラーが発生した場合、プログラムはエラーメッセージを出力して実行を停止します。！

require() ステートメントにファイルの URL を宣言することでリモートファイルが含まれており、リモートサーバーが PHP コードに従ってファイルを解釈する場合、ローカル PHP ファイルに含まれるコンテンツは処理の結果です。リモートサーバー上で。例:
/*
この例では、some_server サーバーは .php ファイルを解釈できるが、.txt ファイルは解釈できないことを前提としています。リモートファイル
には変数 $varfirst と $varsecond が必要です
*/
/*正しく実行できません。リモートサーバーは .txt ファイルを処理しません*/
require("http:// some_server/file .txt?varfirst=1&varsecond=2");

/*不正解です。file.php ファイルはローカルマシン上でのみ見つかります*/
require("file.php?varfirst) =1&varsecond=2 ");

/*正しいステートメント*/
require("http://some_server/file.php?varfirst=1&varsecond=2");

$ varfirst=1 ;
$varsecond=2;
require("file.txt"); /*正しいステートメント*/
もともとphp3.0ではrequire()にインクルードされたファイルはreturn文を使用できるのですが、条件としてreturn文は{}内には出現できず、インクルードされたファイルのグローバルスコープ内に出現する必要があります。この require() の機能は php4.0 で廃止されましたが、 include() を使用して実装することができます。

2.include() ステートメント include() ステートメントと require() ステートメントには多くの類似点があります。上記の require() ステートメントで明示的に記述されておらず、include() に適用できない部分を除いて、require() ステートメントの関数は include() ステートメントに完全に適用できます。以下では、require() ステートメントでは使用できない include() ステートメントの機能と特徴について説明します。
include ステートメントは、実行時にインクルードされるファイルのみを読み取ります。エラー処理を容易にするために、include ステートメントを使用します。include エラーが発生した場合、プログラムはエラーメッセージが表示されますが、プログラムは実行を続行します。
PHP プロセッサは include() ステートメントを検出するたびにそれを再処理するため、条件付き制御ステートメントやループステートメントで include() を使用して、さまざまな状況に応じてさまざまなファイルをインクルードできます。
例:
$files=array('first.php','first.php','third.php');
for($i=0; $ i {
include $files[$i];
}
?>
include( ) ステートメントでは return ステートメントを使用できます。値を返し、インクルードされたファイルの下のコンテンツの実行を停止します。ただし、php3.0 と php4.0 では、そのような状況の処理方法が異なります。 php3.0 では、return ステートメントを関数内にしない限り、{} 内に含めることはできません。これは、return ステートメントがファイルの戻り値ではなく関数の戻り値を表すためです。 php4.0 では、そのような制限はなく、関数の戻り値と同様に、ファイル内で数値を返すこともできます。このようなステートメントは通常、

php3.0 でエラーを報告します。以下は例です:
インクルードされたファイルが test.inc で、メインファイル main.php がディレクトリにあると仮定します。 test.inc の内容は次のとおりです。
test.inc
echo "Before the return
n";
if(1)
{
return 27 ;
}
echo "return
?>

main.php ファイルに次のステートメントが含まれているとします。 ?php
$retval=include('test.inc');
echo "返されたファイル:'$retval'
n";
?> php3.0 インタープリターwill 2 行目はエラーを報告し、include() ステートメントの戻り値を取得できません。しかし、php4.0 では、次の結果が得られます:
リターン前
返されたファイル: '27'
main.php が次のように変更されたと仮定します:
include( 'test.inc');
echo "Back in main.html
n";
?>
php4.0 の出力は次のとおりです。 🎜 > main.html に戻る

php5.0 での出力結果も次のとおりです。
return 前
main.html に戻る

php3.0 での出力結果は:
リターンの前
27main.html に戻る

解析エラー:/apache/htdocs/phptest/main.html の 5 行目の解析エラー

上記が表示されますこのエラーは、return ステートメントが関数内ではなく {} 内にあるために発生します。 {} を削除して test.inc の最外層に配置すると、出力結果は次のようになります。
return の前
27Main.html に戻る
27 が表示される理由は、php3 にあるためです。 .0 Include() リターンはサポートされていません。

3. require_once() および include_once() ステートメント

require_once() および include_once() ステートメントは、それぞれ require() ステートメントおよび include() ステートメントに対応します。 require_once() および include_once() ステートメントは主に、複数のファイルをインクルードする必要がある場合に使用され、同じコード部分をインクルードすることによって発生する関数または変数の繰り返し定義でのエラーを効果的に回避できます。例: 2 つのファイル util.inc と Fool.inc を作成する場合、プログラムコードは次のようになります。
echo "GLOBALS ARE NICE
n";
function goodTea()
{
return "オーロン茶はおいしいです!";
そして、fool.inc:
require ("util.inc");
function showVar($var)
{
if(PHPVERSION==4)
{
print_r($var);
} }
else
} {
var_dump($var);
?> > 次に、error_require .php には次の 2 つのファイルが含まれます:
require("fool.inc");
require("util.inc");//この文はエラーを生成します。
$foo=array("1",array("complex","quaternion"));
echo "これはまた util.inc を必要としますが、これも
echo "; folk .incn で必要です";
echo "goodTea:".goodTea() を実行しています。"
n";
echo "foo:
n を印刷しています";
showVar($ foo);
?>
error_require.php を実行すると、出力は次のようになります:
GLOBALS ARE NICE
GLOBALS ARE NICE

Fatal error:Cannot redeclare goodTea() util.inc の 4 行目

require() ステートメントの代わりに require_once() ステートメントを使用すると、上記のエラーは発生しません。 error_require.php と folk.inc の require() ステートメントを require_once() ステートメントに変更し、その名前を error_require_once.php に変更しました。結果は次のようになります:
グローバルは便利です
これは再び util.inc を必要とします。これは、fool.inc でも必要です。
実行中 GoodTea:Olong tea おいしい!
Printing foo:
Array([0] => 1 [1] => Array ([0] =>) ; complex [1] = quaternion))

include_once() ステートメントの構文は include() ステートメントと似ていますが、主な違いは、複数のファイルを含めることによって生じる関数または変数の定義の繰り返しを避けることです。回。

require_once ステートメントには参照チェーンがあり、ファイルがプログラムに 1 回だけ追加されることが保証され、変数値と関数名の競合が回避されます。

require_once ステートメントと同様に、include_once ステートメントは include の機能を拡張します。プログラムの実行中に、指定されたファイルがインクルードされます。そのファイルから参照されるプログラムが以前にインクルードされている場合、include_once() はそれを再度インクルードしません。つまり、同じファイルは 1 回しか参照できません。

include_once() ステートメントは、スクリプトの実行中に指定されたファイルをインクルードし、実行します。この動作は include() ステートメントに似ていますが、唯一の違いは、ファイル内のコードが既にインクルードされている場合、再度インクルードされないことです。このステートメントの名前が示すように、このステートメントは 1 回だけ含まれます。

include_once() は、スクリプトの実行中に同じファイルが複数回インクルードされる可能性があり、関数の再定義や変数の再割り当てなどの問題を避けるために、ファイルが 1 回だけインクルードされるようにしたい場合に使用する必要があります。

require_once() と include_once() の使用例については、最新の PHP ソースプログラム配布パッケージの PEAR コードを参照してください。

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

注: include_once() は PHP 4.0.1pl2 で新たに追加されました。

注: 大文字と小文字を区別しないオペレーティングシステム (Windows など)

における include_once() および require_once() の動作は予期しない可能性があることに注意してください。
例: Windows では include_once() は大文字と小文字を区別しません

include_once("a.php") // これには a.php が含まれます
include_once( " A.php"); // これにより、Windows では a.php が再びインクルードされます! (PHP 4 のみ)
?>

この動作は PHP 5 で変更され、パスが最初に正規化されるため、 C:PROGRA~1A.php と C:Program Filesa.php の実装は同じであり、ファイルは 1 回だけインクルードされます。

インクルードするファイルが存在しない場合、 include は通知を表示し、次のステートメントの実行を続行します。 require は致命的なエラーを表示して終了します。

win32 プラットフォームでは、これらは最初にインクルードされてから実行されるため、ディレクトリの混乱を引き起こす可能性があるため、インクルードされたファイルに include または require ステートメントを含めないことをお勧めします。 Linux では状況が異なる可能性がありますが、まだテストしていません。

ファイルを複数回インクルードしたくない場合は、include_once または require_once## を使用してドキュメントデータの読み取りと書き込みを行うことができます。
function r($file_name) {
$filenum=@fopen($file_name,"r");
@flock($filenum,LOCK_SH); file_data=@fread($filenum,filesize($file_name));
@fclose($filenum);
関数 w($file_name,$data,$method) ="w"){
$filenum=@fopen($file_name,$method);
$file_data=fwrite($filenum,$data); > fclose($filenum);
return $file_data
}
?>