PHPのインクルード機能 require の基本と使い方を解説

<?php
// config.php
$configValue = "設定値";
// main.php
// config.phpの内容を読み込み
require "config.php";
// 読み込んだ変数を出力
echo $configValue;

設定値

<?php
// 存在しないファイルを読み込み
require "nonexistent.php";
// この行は実行されません
echo "このメッセージは表示されません。";

Fatal error: require(): Failed opening required 'nonexistent.php' (include_path='.:/usr/share/php') in /path/to/main.php on line 3

<?php
// 存在しないファイルを読み込み
require "nonexistent.php";
echo "この行は実行されません。";

Fatal error: require(): Failed opening required 'nonexistent.php' (include_path='.:/usr/share/php') in /path/to/script.php on line 2

<?php
// 存在しないファイルを読み込み
include "nonexistent.php";
echo "この行は実行されます。";

Warning: include(nonexistent.php): failed to open stream: No such file or directory in /path/to/script.php on line 2
Warning: include(): Failed opening 'nonexistent.php' for inclusion (include_path='.:/usr/share/php') in /path/to/script.php on line 2
この行は実行されます。

<?php
// current.php
// __DIR__で現在のディレクトリを取得し、config.phpを読み込む
require __DIR__ . "/config.php";
// config.phpの変数を使用して出力
echo $configValue;

設定値

<?php
// main.php
// 相対パスでincludes/config.phpを読み込み
require "includes/config.php";
// 読み込んだ変数を出力
echo $configValue;

設定値

<?php
// header.php
// ヘッダー部分の出力
echo "サイトヘッダーです。";
// main.php
// __DIR__で絶対パスを指定してheader.phpを読み込み
require __DIR__ . "/header.php";
// 続く処理…
echo "コンテンツ部分です。";

サイトヘッダーです。コンテンツ部分です。

<?php
// 存在しないディレクトリからファイルを読み込む例
require __DIR__ . "/nonexistent/header.php";
echo "このメッセージは実行されません。";

Fatal error: require(): Failed opening required '/path/to/nonexistent/header.php' (include_path='.:/usr/share/php') in /path/to/main.php on line 2

<?php
// main.php
// require_onceを使用して同じファイルを複数回読み込む
require_once __DIR__ . "/config.php";
require_once __DIR__ . "/config.php";
// 変数$configValueが一度だけ定義されているため、エラーが発生しません
echo $configValue;

設定値

<?php
// チェックするファイルのパスを設定
$filePath = __DIR__ . "/config.php";
// ファイルが存在するか確認してから読み込み
if (file_exists($filePath)) {
    require $filePath;
    echo $configValue;
} else {
    echo "設定ファイルが見つかりません。";
}

設定値

<?php
// ログに出力する対象のファイル
$filePath = __DIR__ . "/config.php";
// ファイルが存在しない場合はエラー情報をログに記録
if (!file_exists($filePath)) {
    error_log("【エラー】config.php が存在しません。");
    exit;
}
// 問題なければファイルを読み込み
require $filePath;
// 読み込んだ変数を出力
echo $configValue;

設定値