PHPでファイルを読み込む方法として多く使われる「require」と「include」。この2つの違いを明確に理解していますか。エラー発生時の挙動、処理の安全性、実際の使いどころ、パフォーマンスなど、誤解されたまま使い続けると大きなトラブルの原因になります。この記事では「PHP require include 違い」の観点から、それぞれの機能、応用、失敗時の振る舞い、そして最適な選び方までを丁寧に解説します。ぜひ最後まで読んで、使い分けに自信を持てるようになりましょう。
目次
PHP require include 違い：基本的な動作とエラー処理
requireとincludeはいずれもPHPで別ファイルを現在のスクリプトに読み込み、実行するための構文です。ただし最も大きな違いは、ファイルが存在しなかったり読み込めなかった場合のエラー処理にあります。requireは致命的なエラーを発してスクリプトの実行を直ちに停止させますが、includeは警告（Warning）を発するだけで処理を継続します。
この違いが意味するのは、必須ファイルかどうかに応じて構文を選ぶことでコードの予期しない動作を避けられるということです。たとえば設定ファイルやコアロジックを含むファイルを読み込む際にはrequireを用いることで、ファイル欠損によるセキュリティリスクや動作不具合を防げます。
requireの挙動：Fatal Error と処理の停止
requireは読み込むファイルが見つからないとき、Fatal Errorを発生させてスクリプトを途中で止めます。つまり、そのファイルが存在しないとそれ以上後続処理を実行できないような構成のときにはrequireを使うのが適切です。設定ファイルやデータベース接続、クラス定義など、欠かせない要素を含むファイルに適しています。
またrequireはincludeと異なり関数やクラスを再定義できるような重複呼び出しには注意が必要です。そのためrequire_onceを用いるなど重複を防ぐ手段を取ることが推奨されます。
includeの挙動：Warning と処理継続
includeはファイルが見つからないなどの問題があっても、Warningを出すだけでスクリプトは継続します。ページのデザインテンプレートの一部やログ記録ファイルなど、欠損しても致命的でないファイルを読み込む際にincludeが使われます。
ただし実際に表示が崩れる可能性や、期待した処理が実行されないためにバグの原因となることもあります。そのため、スクリプト全体の動作に重大な影響を及ぼすファイルについては、includeではなくrequireを選択することが安全です。
エラー種類とPHPバージョンでの変化
includeが失敗したときにはE_WARNINGレベルのエラーが発せられ、requireが失敗するとFatalなE_ERROR（あるいはPHPのバージョンによってはE_COMPILE_ERRORなど）が発せられて停止します。最新のPHPでもこの基本的な振る舞いは変わっていません。
またPHPの進化によりinclude_pathの扱い、読み込まれるファイルのパスの解決方法、内部でのnamespaceとの統合など細かな動作が改善されています。こうした点も意識することで思わぬエラーを避けられます。
require_once・include_onceを含めた拡張的な使い方
require_onceとinclude_onceは、それぞれrequire・includeの拡張で、同じファイルを複数回読み込むことを防ぐ機能を持ちます。関数やクラスの重複定義によるエラーを避けたい場合に非常に有用です。最新のPHP実装でもパフォーマンス上の僅かなコストはありますが、安全性を考慮するならばしばデフォルトの選択肢になります。
ただし、include_onceやrequire_onceを濫用するとオーバーヘッドが発生しやすく、特に大量のファイル読み込みが行われる環境では注意が必要です。モジュール構成やオートローダーを使う設計を併用することで最適化可能です。
重複読み込み防止の仕組み
include_onceやrequire_onceは、PHPがそのファイルを一度でも読み込んでいればそれ以降の読み込みをスキップします。この仕組みによって、関数やクラスの再定義エラーを防げます。この機能は読み込むファイルの中身によっては不可欠であり、安全なコード実装には重要です。
パフォーマンスへの影響と注意点
_once版の構文を使用すると、PHPは内部でファイルが既に読み込まれたかどうかをチェックする処理を挟むため、標準のincludeやrequireより若干遅くなります。しかしこれは大規模プロジェクトや頻繁に読み込みを行う場面でのみ実際的に意識すべき違いです。
コード設計上での使い分け方
コア部分（設定ファイル、データベース接続、クラス定義など）にはrequire_onceを使い、一度だけ読み込むように設計します。テンプレートやテーマの一部など、同じ構成が複数ページで共有されるが重複読み込みが問題にならない部分にはincludeやinclude_onceを使うとバランスが良くなります。
ファイルパスの指定と読み込まれるパス解決の違い
読み込むファイルのパス指定方法にもrequireとincludeで注意すべき違いはほとんどありませんが、PHPのinclude_path設定や相対パス・絶対パスの扱い、__DIR__などによる基準点の違いによってトラブルが生じやすい部分があります。最新のバージョンでもこれらは改善されつつありますが、明示的なパス指定が安全です。
ファイルがあると思っていた場所にない、パーミッションが足りていない、include_path内に設定されていないなどの理由で読み込みに失敗するケースが多いため、エラー発生時の挙動を理解しておくことが重要です。
相対パスと絶対パスの使いどころ
相対パスは呼び出し元ファイルの場所や実行ディレクトリによって基準が変わるため、includeやrequireで指定しても意図したファイルが見つからないことがあります。これを避けるため、常に__DIR__定数を用いて現在のファイルのディレクトリを起点にパスを指定する方法が推奨されます。
include_pathの設定と影響
PHPの設定で指定されたinclude_pathは、指定されたファイル名を探すディレクトリリストです。相対パスや単にファイル名だけを書いた場合、まずinclude_pathが参照され、それでも見つからない場合に呼び出し元のディレクトリや作業ディレクトリが見られることがあります。requireも同様ですが、失敗時の停止するかどうかが異なります。
namespaceやオートローダーとの関係
近年のPHPコードベースではオートローダーを使いクラスや関数を自動読み込みする設計が主流です。この場合、require_onceやinclude_onceを使う機会が減りますが、オートローダー内部ではrequireまたはrequire_onceが使われることが多いです。namespaceを用いた分割設計でも、正しくパス解決できるように構成ファイルを整理する必要があります。
実際の例で比較：どちらをいつ使うかのケーススタディ
具体的な例を通じて、PHP require include 違いを意識して選ぶべき場面を見ていきます。開発と運用、それぞれの環境で何を選べば良いかを理解することで、エラーを未然に防げますしコードの保守性を高められます。
複数のテンプレートファイルを持つWebアプリケーションを想定します。ヘッダー・フッター・サイドバーなどのUIパーツ、そして設定や共通関数を含むコアモジュールに分けられている構成です。
コアモジュールをrequire_onceで読み込む例
設定ファイルやデータベース接続など、アプリケーションが正しく動くために必須なファイルはrequire_onceで読み込むべきです。たとえばconfig.phpやfunctions.phpを最初にrequire_onceで読み込むことで、重複読み込みや未定義のエラーを防ぐことができます。
この方法で、同じ関数や定数が複数回定義されることを回避し、開発環境や本番環境で予期しないクラッシュを防げます。また、require_onceは単にrequireよりも安全性が高いため、これらのファイルにはまずrequire_onceが選択される傾向があります。
テンプレートとレイアウト部分をincludeで柔軟に扱う例
ヘッダーやフッター、サイドバーといったテンプレート部分は、includeを使うことでそのファイルが存在しなくてもページの主要部分は表示され続けます。一部のパーツの欠落が致命的でない場合にはこうした構成がユーザー体験を損なわずに済むでしょう。
例えばbanner.phpが消えていても、サイトのメイン記事部分は表示されるようにしておきたい場合、includeを使います。警告をログに残しておき、後で復元可能な設計にします。
開発環境と本番環境での使い分け
開発環境ではエラー検出を重視するため、多くのrequireやrequire_onceを用いて必須ファイルの読み込みを保証させる設計が好まれます。本番環境では、致命的な停止を避けるために処理の継続性を持たせる部分にはincludeを使うなどバランスのある使い分けが必要です。
さらにログ出力や監視を行うことで、Warningだけが出るケースも見逃さずに把握できるようにしておくことが運用上重要です。
セキュリティとトラブルシューティングの観点から
PHP require include 違いを理解する上でセキュリティ問題やトラブル発生時にどう対応するかも極めて重要です。不適切な読み込みを許しているとファイル包含型の脆弱性（LFIやRFI）につながる恐れがあります。最新の情報ではユーザー入力によるパス操作を適正に制御することや適切なパーミッション設定が推奨されています。
またトラブルが起きたときにはエラーメッセージの内容を見て、どちらの構文が使われていたかを確認することで原因特定が速くなります。
LFI／RFIのリスクと対策
ユーザー入力を基にファイルパスを指定する場合にincludeやrequireを使うと、意図しないファイルを読み込まれてしまうリスクがあります。これを防ぐためには入力値の検証、ベースディレクトリの限定、ホワイトリスト方式などを使います。
ファイルの存在や権限不足で起こる典型的な失敗例
読み込むファイルのパスが間違っている、ファイルが設置されていない、あるいは適切な読み取り権限がない場合、includeではWarning、requireではFatal Errorになります。特にパーミッションや所有者が読み取り可能であることを確認することが重要です。
エラー表示設定と非本番環境でのデバッグ技術
本番環境ではFatal ErrorやWarningの表示を抑える設定になっていることが多いため、ログに記録されているかを確認する必要があります。ini設定やエラーハンドラの設定を利用して、WarningやFatal Errorをログに残すことで後から問題を把握できます。
パフォーマンス・ベストプラクティス：最適化のための選択肢
requireとincludeに加えてその_once版の使用、パスの解決方法、オートローダーやキャッシュ利用などを通じて、ファイル読み込みによるオーバーヘッドを抑える方法があります。最新のPHPではこうした最適化手段も整っていますので、パフォーマンスが気になる現場では意識的に採用されることが多いです。
ファイルが多数存在するモジュール構成、大量ページアクセスがあるWebサイトでは、読み込みの頻度やファイル数の増加がパフォーマンス低下の原因になり得ます。対策としてオートローダーを使用したり、include_once／require_onceの過剰使用を避けたりすることが有効です。
キャッシュとオートローダーの併用
コードベースをcomposerなどのオートローダーで構成し、必要なクラスや関数を自動で読み込ませる設計にすることで、個別にファイルをrequire/includeする手間や重複の機会を減らせます。さらにオプコードキャッシュを有効にしておけば、同じスクリプトの読み込みコストを低減できます。
読み込み回数を減らす工夫
include_once／require_onceで重複を防ぐのはもちろんですが、レイアウトテンプレートをまとめたり、共通パーツを一箇所にまとめて読み込んだりと構成を整理することでアクセスごとの読み込み数を削減できます。これによりファイルシステムのI/O負荷が減ります。
オーバーヘッドと小規模プロジェクトのバランス
小規模プロジェクトではinclude_onceやrequire_onceの差異やオートローダー導入のコストがかえって複雑さを増すこともあります。そのため必要に応じて平易な構成を選び、将来規模が大きくなったら構成を見直す戦略が有効です。
まとめ
PHPにおけるrequireとincludeの違いは主としてエラー発生時の挙動とスクリプトの継続可否にあります。requireは致命的なエラーを発して処理を止めるため必須ファイルに用い、includeは警告を出して処理を継続するため柔軟性の必要なテンプレート系などに適しています。
さらに、require_once／include_onceを使うことで重複読み込みを防ぎ、安全性と保守性を高めることができます。また、パスの指定方法、include_pathの利用、パーミッションの設定などに注意することでトラブルを減らせます。
最終的には、必須かどうか、重複定義の抑制が必要かどうか、プロジェクトの規模や運用環境などに応じて使い分けることが最適です。PHP require include 違いを理解し適切に選択することで、コードの信頼性と可読性が大きく向上します。
コメント