無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

require()

require()文は指定されたファイルを読み込み、評価します。 ファイルが読み込まれ評価される際の詳細な情報に関しては include()に記述されています。

require()include() は、エラーの扱い方を除けば全く同様に振舞います。エラーが発生するとどちらも Warning を出力しますが、require() を使用している場合は Fatal Error となります。 言い換えると、指定されたファイルが無い場合に処理を停止したい場合は require() を使用した方が良い、ということになります。 include() を使用すると、 読み込むべきファイルが存在しない場合も処理が続行されます。 include_path を適切に設定することも忘れないでください。

例1 基本的なrequire()の例

<?php

require 'prepend.php';

require 
$somefile;

require (
'somefile.txt');

?>

include()のドキュメントにはさらに多くの例がありますので 参照してください。

注意: PHP 4.0.2以前での挙動は以下の様になっています: require()は その行が実行される/されないにかかわらず常に指定されたファイルを読み込もうと します。従って条件文はrequire()には影響を与えません。 しかしながら、require()がある行が実行されない場合、 読み込まれるファイル内のコードは実行されません。同様に、ループ構造は require()の動作には影響しません。読み込まれるファイル内の コードがループに依存している場合でも require()は 読み込みを一回しか行いません。

注意: これは、関数ではなく 言語構造のため、可変関数 を用いて コールすることはできません。

警告

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

include(), require_once(), include_once(), get_included_files(), eval(), file(), readfile(), virtual() および include_path も参照ください。