includeとrequireの違い

この2つの命令は似たような機能を持ちますが、エラー処理の方法に重要な違いがあります。

  • includeは警告を表示して処理を続行するのに対し、
  • requireはエラーが発生するとスクリプトを停止します。

本記事では、includeとrequireの違いを理解し、適切な命令の選び方をご紹介します。

includeとrequireの比較

includeとrequireは、PHPで別のファイルを現在のファイルに読み込む命令という共通点がありますが、重要な違いがあります。includeは読み込むファイルが存在しない場合でも警告を出してスクリプトを続行しますが、requireはファイルが存在しないとエラーを発生させ、スクリプトの実行を中断します。

includeとrequireの比較
比較項目 include require
機能 include命令を使ってファイルを読み込みます require命令を使ってファイルを読み込みます
使用例 include 'ファイルパス.php' include 'require.php'
エラー発生時 警告（Warning）のみ表示してスクリプトを続行します 致命的なエラー（Fatal error）を発生させてスクリプトを停止します
ファイルの重複読み込み 読み込み 読み込み

includeとrequireの派生形として、include_onceとrequire_onceがあります。
名前の通り、これらの命令は読み込むファイルがすでに現在のファイルに含まれているかを確認し、同じファイルを一度だけ読み込むようにします。同じファイルを複数回読み込んでしまうと、そのファイル内の関数や変数が重複定義され、エラーや意図しない結果を引き起こすことがあるため、防止に役立ちます。
ただし、includeやrequireに比べて実行速度がやや遅くなる点には注意が必要です。

include_onceとrequire_onceの比較
比較項目 include_once require_once
機能 include_once命令を使ってファイルを読み込みます require_once命令を使ってファイルを読み込みます
使用例 include_once 'ファイルパス.php' include_once 'require.php'
エラー発生時 警告（Warning）のみ表示してスクリプトを続行します 致命的なエラー（Fatal error）を発生させてスクリプトを停止します
ファイルの重複読み込み 読み込みなし 読み込みなし

includeとrequireの適切な選び方

includeとrequireはファイルを読み込む命令ですが、どちらを選ぶかは状況や要件によって異なります。
以下に適切な選択基準を示します。

  1. ファイルの必須性
  2. ファイルの選択性
  3. 重複読み込みの有無
  4. エラー処理の要件

ファイルの必須性

読み込むファイルが必須で、スクリプトの実行に不可欠な場合は、requireを選んでください。requireは読み込むファイルが存在しないとエラーを発生させてスクリプトを停止します。必須ファイルがないとスクリプトが正常に動作しない場合に有効です。

例の状況 - ウェブアプリケーションでデータベース接続情報を読み込む必要がある場合です。

PHP 
// database.php

// データベース接続情報
$host = 'localhost';
$username = 'myusername';
$password = 'mypassword';

// その他のデータベース設定

// データベース接続
$db = new PDO("mysql:host=$host;dbname=mydatabase", $username, $password);
PHP 
/ main.php

// データベース接続情報は必須
require 'database.php';

// その他のコードを実行

// データベース関連の処理を行う

上記の例では、database.phpファイルにデータベース接続情報に関するコードが含まれています。このファイルの内容はmain.phpで必須となる部分です。データベース接続情報がなければ、main.phpは正しく動作できません。

したがって、main.phpではrequire命令を使ってdatabase.phpファイルを必須で読み込みます。これによりデータベース接続情報を含め、ファイルが存在しない場合はエラーが発生してスクリプトが停止します。これによって必須ファイルの存在を検証し、スクリプトが正常に動作することを保証できます。

ファイルの選択性

読み込むファイルが任意で、スクリプトの実行に影響しない補助的な部分であれば、includeを選んでください。include命令は読み込むファイルがなくても警告を表示するだけで、スクリプトの実行を続行します。任意のファイルで、なくてもスクリプトが正常に動作する場合に便利です。

例の状況 - ウェブアプリケーションでログ記録用のファイルを読み込む場合です。

PHP 
// logging.php

// ログ作成関数
function writeLog($message) {
    // ログ作成コード
    // ...
}
PHP 
// main.php

// ロギングファイルを任意で読み込み
include 'logging.php';

// その他のコードを実行

// 必要に応じてログ作成
writeLog('イベント発生');

上記の例では、logging.phpファイルにログ作成用の関数が含まれています。このファイルはログを任意で使用したい場合に読み込むファイルです。ログ機能はスクリプトの実行に直接影響せず、補助的な役割を果たします。

したがって、main.phpではinclude命令を使ってlogging.phpファイルを任意で読み込みます。これによりログ機能を含め、ファイルが存在しない場合は警告のみ表示され、スクリプトは実行を続行します。これにより必要に応じてログを有効化し、ファイルがなくてもスクリプトが正常に動作できる柔軟性を提供できます。

重複読み込みの有無

ファイルを重複して読み込む必要があるかどうかに応じて、includeまたはrequireを選んでください。同じファイルを複数回読み込む場合はincludeを使えば問題ありません。しかし、重複読み込みを防ぐ必要がある場合は、include_onceまたはrequire_onceを使って重複読み込みを防止できます。

例の状況 - ウェブページで特定のモジュールファイルを複数回読み込む必要がある場合です。

PHP 
// module.php

// モジュールの内容を出力
echo 'これはモジュールです。';
PHP 
// main.php

// 特定のモジュールファイルを重複して読み込み
include 'module.php';
include 'module.php';

// ページ内容を出力
echo '<main>';
// ...
echo '</main>';

上記の例では、module.phpファイルに特定モジュールの内容が含まれています。このファイルはウェブページで繰り返し使用されるモジュールを定義しています。同じモジュールを複数回読み込む必要がある場合があります。

したがって、main.phpではinclude命令を使ってmodule.phpファイルを重複して読み込みます。これにより、必要な回数だけ同じモジュールを重複して読み込むことができます。重複読み込みを許可する場合は、include命令でファイルを複数回読み込めます。上記の例は、重複読み込みが許可される状況でinclude命令を使う方法を示しています。重複読み込みが必要な場合は、include命令を選択して使えば問題ありません。

エラー処理の要件

スクリプトでエラーが発生した際の処理方法に応じて、includeまたはrequireを選んでください。includeはエラーがあっても警告を表示するだけでスクリプトの実行を続けます。一方、requireはエラーが発生するとスクリプトを停止させます。したがって、エラー発生時にスクリプトを中断させる必要がある場合はrequireを選択してください。

例の状況 - ウェブアプリケーションで設定ファイルを読み込む場合です。

PHP 
// config.php

// 設定値の定義
$database_host = 'localhost';
$database_username = 'myusername';
$database_password = 'mypassword';
// ...
PHP 
// main.php

// 設定ファイルの必須読み込み
require 'config.php';

// その他のコード実行

// 設定値の使用
$connection = new DatabaseConnection($database_host, $database_username, $database_password);
// ...

上記の例では、config.phpファイルにウェブアプリケーションの設定値が含まれています。このファイルは必要な設定値を定義しており、設定ファイルが存在しない場合はスクリプトを中断する必要があります。

したがって、main.phpではrequire命令を使ってconfig.phpファイルを必須で読み込みます。これにより、設定ファイルが存在しないかエラーが発生した場合にエラーが表示され、スクリプトが中断されます。設定ファイルはアプリケーションの動作に不可欠なため、エラー発生時にはスクリプトを停止させるrequireを選択します。

上記の例では、設定ファイルを必須で読み込む必要がある状況を扱っています。
設定ファイルが必要で、エラーが発生した場合にスクリプトを中断させる場合に、require命令を使って設定ファイルを読み込む方法を示しました。これにより、設定ファイルの存在を検証し、必須の設定値を正常に使用できます。

includeとrequireの違い理解の重要性

includeとrequireを理解することは、PHP開発者にいくつかの利点をもたらします。

  • 柔軟なコード構成： includeやrequireを理解することで、コードをモジュール化し、再利用可能なコンポーネントとして分離することが可能になります。必要なタイミングで必要なファイルを読み込むため、コードをより柔軟に構成できます。
  • 必須ファイルの読み込み: requireは、読み込まれるファイルが必須であることを示すため、必須ファイルの処理に適しています。エラーが発生した場合にスクリプトの実行を停止させる特性があるため、必要なファイルが欠落している場合には、開発者に警告を与えることができます。
  • 任意ファイルの読み込み: includeは、読み込まれるファイルが任意であることを示すため、任意ファイルの処理に便利です。ファイルが存在しない場合でも警告が表示されるだけで、スクリプトの実行は継続されます。これにより、必要に応じてファイルを読み込むことができ、ファイルが存在しなくてもスクリプトが正常に動作するようにできます。
  • 重複読み込みの管理: include_onceやrequire_onceを使用することで、同じファイルが複数回読み込まれるのを防ぐことができます。これにより、コードの一貫性を保ちながら、予期しないエラーや挙動を回避することが可能になります。
  • エラー処理の制御: requireはエラーが発生した場合にスクリプトの実行を停止させるため、エラー処理をより効果的に制御することができます。必須ファイルが存在しない場合やエラーが発生した場合にスクリプトを停止させることで、例外的な状況に適切に対処できます。

上記の利点は、PHP開発者にとってコードの構造や柔軟性を改善し、必須ファイルと任意ファイルの管理、中⻑な読み込みの防止、エラー処理の制御に役立ちます。これらの特性を活用することで、効率的かつ安定したPHPアプリケーションの開発が可能になります。

参考資料