関数 require_once
関数 require_once は指定されたファイルを現在のスクリプトに読み込みます。ファイルが既に読み込まれている場合、関数は再度読み込みを行いません。これは、クラスや関数が定義されているファイルを読み込む際に特に便利で、重複読み込みによるエラーを防ぎます。
構文
require_once 'path/to/file.php';
例
ファイル config.php を読み込む:
<?php
require_once 'config.php';
echo $config['site_name'];
?>
コードの実行結果(config.php で $config 配列が定義されている場合):
'My Site'
例
同じファイルを繰り返し読み込もうとする例:
<?php
require_once 'functions.php';
require_once 'functions.php'; // この呼び出しは無視される
echo sum(2, 3);
?>
コードの実行結果:
5
require との違い
require とは異なり、関数 require_once はファイルが既に読み込まれているかどうかを確認し、重複読み込みを行いません。これにより、同じファイルを複数回読み込むことによるエラーを防ぎます。
関連項目
-
ファイルを読み込むが、重複読み込みをチェックしない関数
include
-
require_once と同様に動作するが、ファイルがない場合に致命的エラーを発生させない関数
include_once