関数 require_once

関数 require_once は指定されたファイルを現在のスクリプトに読み込みます。ファイルが既に読み込まれている場合、関数は再度読み込みを行いません。これは、クラスや関数が定義されているファイルを読み込む際に特に便利で、重複読み込みによるエラーを防ぎます。

構文

phprequire_once 'path/to/file.php';

例

ファイル config.php を読み込む：

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

コードの実行結果（config.php で $config 配列が定義されている場合）：

php'My Site'

例

同じファイルを繰り返し読み込もうとする例：

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // この呼び出しは無視される
  echo sum(2, 3);
?>

コードの実行結果：

php5

require との違い

require とは異なり、関数 require_once はファイルが既に読み込まれているかどうかを確認し、重複読み込みを行いません。これにより、同じファイルを複数回読み込むことによるエラーを防ぎます。

関連項目