require_once

リクワイアワンス（制御構造）

意味必須ファイルを一度だけ読込

require_onceとは？

require_once は、PHPスクリプトに必要な外部ファイルを一度だけ読み込む関数です。ファイルが見つからない場合はエラーを発生させ、プログラムの実行を停止します。

require_onceの具体的な使い方

クラス定義ファイルの読み込み

<?php
// データベース接続クラスを定義したファイルを一度だけ読み込む
require_once 'DatabaseConnection.php';

// クラスを使用してデータベースに接続
$db = new DatabaseConnection();
$connection = $db->connect();

if ($connection) {
    echo "データベースに接続しました。\n";
    
    // 再度require_onceを使用しても、ファイルは読み込まれない
    require_once 'DatabaseConnection.php';
    
    $result = $db->query("SELECT * FROM users LIMIT 1");
    print_r($result);
} else {
    echo "データベース接続に失敗しました。";
}
?>

👇出力結果

データベースに接続しました。
Array
(
    [0] => Array
        (
            [id] => 1
            [name] => 山田太郎
            [email] => [email protected]
        )

)

この例では、'DatabaseConnection.php'というデータベース接続クラスを定義したファイルを一度だけ読み込んでいます。require_onceを使用することで、クラス定義の重複を防ぎ、エラーを回避します。ファイルが見つからない場合はエラーが発生し、プログラムが停止します。2回目のrequire_onceは無視されるため、クラスを安全に使用できます。

require_onceに関するよくある質問

Q. require_onceとrequireの違い

A. require_onceは、指定されたファイルが既に読み込まれている場合、再度の読み込みを行いません。一方、requireは同じファイルを何度でも読み込みます。require_onceを使用することで、関数や変数の再定義を防ぎ、より安全なコードを書くことができます。

Q. require_onceの使用タイミング

A. require_onceは、クラス定義やライブラリ、設定ファイルなど、一度だけ読み込めば十分な場合に使用します。特に、複数のファイルで同じライブラリを使用する可能性がある場合や、循環参照を避けたい場合に有効です。

Q. ファイルが見つからない場合は？

A. require_onceで指定したファイルが見つからない場合、Fatal Errorが発生し、スクリプトの実行が停止します。これは、重要なファイルが欠けている状態でプログラムが続行されるのを防ぐためです。

require_onceが学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか？
プログラミング単語帳には、PHPのrequire_onceやswitch、if、yield、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。