require関数

関数 require は、指定されたファイルを現在のスクリプトに接続して実行します。include とは異なり、ファイルが存在しない場合、致命的なエラーを引き起こし、スクリプトの実行を停止します。この関数は、関数、クラス、設定を含む重要なファイルを接続するためによく使用されます。

構文

phprequire 'path/to/file.php';

例

設定ファイルの接続:

php<?php
  require 'config.php';
  echo $db_host; // config.phpからの変数
?>

ファイル config.php が存在する場合、その内容が実行され、変数が利用可能になります。

例

存在しないファイルの接続を試みる:

php<?php
  require 'missing_file.php';
  echo 'この行は実行されません';
?>

ファイル missing_file.php が存在しない場合、スクリプトはエラーで終了します。

requireとincludeの違い

主な違いは、ファイルが存在しない場合、require が致命的なエラーを引き起こすのに対し、include は警告のみを出す点です。

php<?php
  include 'optional_file.php'; // スクリプトは処理を続行します
  require 'required_file.php'; // エラー時にスクリプトは停止します
?>

関連項目