PHP 二重読み込みの回避：include_once と require_once

JPKODA 編集部 May 9, 2026

include や require を使って外部の PHP ファイルを統合する際、実際の開発現場では「エラーの防止」「変数の再定義回避」「予期せぬ副作用（サイドエフェクト）」を防ぐために、特定のファイルを一度だけ読み込むように制御しなければならないケースが多々あります。そこで不可欠となるのが include_once と require_once です。これらは、一回のスクリプト実行中に同じファイルが複数回インクルードされるのを防ぐ安全装置（セーフティメカニズム）を提供します。「ファイルが既に読み込まれているかチェックする」という追加機能を除けば、その挙動は非 once 版のステートメントと全く同じです。

1. include_once の詳細理解

include_once ステートメントは、スクリプト実行中に指定されたファイルをインクルードして実行します。これは include と同様ですが、決定的な違いは、もしそのファイル内のコードが既に include、include_once、require、または require_once によって読み込まれている場合、include_once は二度目の読み込みを行わないという点です。これにより、関数、クラス、定数の重複定義を防ぎ、致命的なエラー（Fatal Errors）を完璧に回避できます。

include_once が存在しないファイルを読み込もうとした場合、警告（WARNING）を生成しますが、スクリプトの実行は継続されます。

データベースの認証情報やアプリケーションの定数を定義した設定ファイルをロードする、よくあるシナリオを見てみましょう。

1.1 基本的な例：設定ファイルのロード

まず、config.php という名前のファイルを作成します。

<?php
// config.php
// 定数の定義
define('DB_HOST', 'localhost');
define('APP_NAME', 'マイ・アプリケーション'); 

// 関数の定義
function getAppName() {
    return APP_NAME;
} 

echo "設定ファイルがロードされました。<br>";
?>

次に、メインスクリプトでまず include を使って複数回読み込み、その後に include_once を試してみます。

まず、include を使用した場合：

<?php
// index_include.php
echo "--- include を使用 ---<br>";
include 'config.php'; // 1回目のインクルード
include 'config.php'; // 2回目のインクルード
include 'config.php'; // 3回目のインクルード 

echo "アプリ名: " . getAppName() . "<br>";
?>

index_include.php を実行すると、以下のエラーが発生します：

--- include を使用 ---
設定ファイルがロードされました。
設定ファイルがロードされました。
設定ファイルがロードされました。
Fatal error: Cannot redeclare getAppName() (previously declared in /path/to/config.php:6) in /path/to/config.php on line 6

致命的なエラー（Fatal Error）によりスクリプトが終了します。定数の重複定義は警告にとどまる場合もありますが、関数の再定義は確実に致命的なエラーを引き起こします。ファイルが3回ロードされたため、関数も3回定義されようとした結果です。

次に、include_once を使用した場合：

<?php
// index_include_once.php
echo "--- include_once を使用 ---<br>";
include_once 'config.php'; // 1回目のインクルード
include_once 'config.php'; // 2回目のインクルード（無視される）
include_once 'config.php'; // 3回目のインクルード（無視される） 

echo "アプリ名: " . getAppName() . "<br>";
?>

index_include_once.php の出力結果：

--- include_once を使用 ---
設定ファイルがロードされました。
アプリ名: マイ・アプリケーション

出力結果から、config.php が一度だけロードされ、致命的なエラーを回避できたことがわかります。

1.2 応用例：共有ユーティリティ関数ライブラリ

sanitizeInput() や formatDate() といった共通のツール関数を必要とする、複数のページを持つ Web アプリを想定してください。これらの関数が utilities.php に定義されており、header.php や footer.php などの各コンポーネントがそれぞれ utilities.php を include している場合、_once メカニズムがなければ即座に再定義エラーが発生します。

utilities.php を作成します：

<?php
// utilities.php
function sanitizeInput($data) {
    return htmlspecialchars(stripslashes(trim($data)));
}
echo "ユーティリティライブラリがロードされました。<br>";
?>

次に、header.php と profile.php の両方がこれらのツールを必要とし、最終的に index.php にインクルードされると仮定します。

header.php:

<?php
include_once 'utilities.php';
echo "ヘッダーコンテンツのロード完了。<br>";
?>

profile.php:

<?php
// utilities.php は既に header.php でロードされているため、今回のインクルードは暗黙的に無視されます
include_once 'utilities.php'; 

echo "ユーザープロフィール: " . sanitizeInput("<script>alert('xss');</script>") . "<br>";
?>

index.php:

<?php
echo "--- ホームページ開始 ---<br>";
include_once 'header.php';
include_once 'profile.php';
echo "--- ホームページ終了 ---<br>";
?>

index.php の実行結果：

--- ホームページ開始 ---
ユーティリティライブラリがロードされました。
ヘッダーコンテンツのロード完了。
ユーザープロフィール: <script>alert('xss');</script>
--- ホームページ終了 ---

「ユーティリティライブラリがロードされました。」というメッセージが一度しか表示されていない点に注目してください。これは utilities.php が header.php の処理時に一度だけインクルードされたことを証明しています。

2. require_once の理解

require_once ステートメントは require と全く同じですが、唯一の違いは、PHP がそのファイルが既にインクルードされているかチェックし、済みであれば二度目のインクルードを行わない点です。include_once と同様に、再定義エラーの防止に不可欠です。

require_once と include_once の主な違いは、ファイルが見つからない時の処理方法です。require_once で指定したファイルが存在しない場合、致命的なエラー（FATAL ERROR）を発生させ、即座にスクリプトの実行を停止します。 これにより、require_once はフレームワークのコアクラスやデータベース接続スクリプトなど、アプリケーションが絶対に依存している重要ファイルのロードに最適な選択肢となります。

2.1 基本的な例：データベース接続

データベース接続ファイル db_connect.php を作成します：

<?php
// db_connect.php
echo "データベースに正常に接続しました。<br>";
$db_is_ready = true;
?>

次に、index_db.php で require_once を使用します：

<?php
// index_db.php
echo "--- データベース接続を試行中 ---<br>"; 

require_once 'db_connect.php'; // 1回目のインクルード
require_once 'db_connect.php'; // 2回目のインクルード（無視される） 

// データベース操作を継続
if (isset($db_is_ready)) {
    echo "クエリの実行が可能です。<br>";
}
echo "--- スクリプト続行 ---<br>";
?>

これにより、負荷の高いデータベース接続操作や変数の初期化が一度だけ実行されることが保証されます。

2.2 欠落した重要ファイルの取り扱い

ファイルが存在しない場合の両者のエラーハンドリングの違いを比較してみましょう。non_existent_file.php は存在しないと仮定します。

include_once を使用した場合：

<?php
echo "include_once の前。<br>";
include_once 'non_existent_file.php'; 

echo "include_once の後。<br>"; // この行は実行されます！
?>

結果： スクリプトは警告（Warning）を出しますが、"include_once の後。" も出力されます。

require_once を使用した場合：

<?php
echo "require_once の前。<br>";
require_once 'non_existent_file.php'; 

echo "require_once の後。<br>"; // この行は【絶対に】実行されません！
?>

結果： スクリプトは警告の直後に致命的なエラーをスローし、実行がその場で遮断されます。重要コンポーネントにおいて、この「実行を許さない」挙動こそが私たちが求めている安全策です。

3. 実践的な応用とベストプラクティス

include_once と require_once の選択は、読み込むファイルの重要度（依存度）に依存します。

require_once でコアコンポーネントをロード： これが欠けるとスクリプトが動作しないファイルに使用します。

設定ファイル（パスワードや API キーを含むもの）。
データベース接続スクリプト。
コアクラスやインターフェースを定義するオートローダー、またはフレームワークファイル。

include_once で非コアコンポーネントをロード： 欠落しても一部の機能に影響するだけで、アプリ全体がクラッシュすべきではないファイルに使用します。

オプションのツール関数ライブラリ。
フロントエンドのテンプレートパーツ（サイドバーや、メインコンテンツに影響しないコメント欄など）。
多言語ローカライズファイル（欠落した場合、デフォルト言語で代用可能）。

3.1 冗長性の削減とパフォーマンスの向上

ファイルを一度だけ読み込むように徹底することは、エラー防止だけでなく以下のメリットもあります：

リソース効率： 同じコードを不必要に繰り返し解析（パース）して実行するのを避けます。小規模なスクリプトでは微々たる差ですが、複雑な依存関係を持つ大規模アプリケーションでは累積的な効果が顕著に現れます。
メンテナンス性： 依存関係の管理が容易になり、ファイルの読み込み順序や重複読み込みを過度に心配することなく開発に集中できます。

3.2 想定シナリオ：ECサイトの商品詳細ページ

ECサイトの商品詳細ページ (product.php) を構築していると想像してください。以下のファイルが必要になるでしょう：

config.php: データベース認証情報（必須 → require_once）
db_connection.php: PDO 接続の確立（必須 → require_once）
product_model.php: Product クラスの定義（必須 → require_once）
promotions.php: キャンペーン情報のチェック（非必須。キャンペーンがなくても商品は販売可能 → include_once）
customer_reviews.php: ユーザーレビューのレンダリング（非必須。レビューのロード失敗で商品ページ自体が表示されないのは避けるべき → include_once）

<?php
// product.php
require_once 'config.php';
require_once 'db_connection.php';
require_once 'product_model.php'; 

// promotions.php が紛失しても、ページはロードされ、割引情報が表示されないだけ
include_once 'promotions.php'; 

// customer_reviews.php が紛失しても、ページはロードされ、レビューが表示されないだけ
include_once 'customer_reviews.php'; 

// ... ページレンダリングのコアビジネスロジック ...
?>

このようなアーキテクチャにすることで、コアコンポーネント欠落時には即座にエラーを検知し、オプションコンポーネントの不具合時には優雅に機能を縮小（グレースフル・デグラデーション）させることができます。