PHPでファイルを読み込む方法：require, include, autoloadの使い分け

PHPでファイルを読み込む方法は複数ありますが、それぞれに特徴があり、適したケースが異なります。本記事では、実際のプロジェクトで使えるファイル読み込みのテクニックを、WordPress、自作PHPフレームワーク、フォームシステムなど、実務で直面する様々なケースに対応できるよう、メリット・デメリット・適用場面を、具体例を交えて解説します。

基本的なファイル読み込み方法4つ

1. `require`

require 'config.php';

特徴：

ファイルが見つからない場合、**Fatal Error（致命的エラー）**でスクリプト停止
毎回ファイルを読み込む（同じファイルを複数回読み込むと再定義エラーの可能性）

メリット：

✅ 必須ファイルの読み込みに最適
✅ エラー時に確実に停止する（安全）

デメリット：

❌ 同じファイルを複数回読み込むと関数/クラスの再定義エラー

適したケース：

データベース接続設定
必須の設定ファイル
フレームワークの初期化ファイル

2. `require_once`（最もよく使われる）

require_once 'initialize.php';

特徴：

ファイルが見つからない場合、Fatal Error
既に読み込み済みなら再読み込みしない

メリット：

✅ 二重読み込みを防止
✅ 必須ファイルに最適
✅ 大規模プロジェクトでも安全

デメリット：

❌ 若干のオーバーヘッド（読み込み済みチェック）

適したケース：

ほぼ全てのケースで推奨
クラスファイル
ヘルパー関数
初期化スクリプト

コード例：

// initialize.php を読み込み（既に読み込み済みならスキップ）
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

// 何度呼んでも安全
require_once ESTFM_PATH . '/helpers/session-helper.php';
require_once ESTFM_PATH . '/helpers/session-helper.php'; // 2回目は無視される

3. `include`

include 'header.php';

特徴：

ファイルが見つからない場合、**Warning（警告）**のみでスクリプト続行
毎回ファイルを読み込む

メリット：

✅ エラーでも処理を続行できる
✅ オプショナルなファイルに最適

デメリット：

❌ 必須ファイルには不向き（読み込み失敗に気づきにくい）

適したケース：

テンプレートパーツ（あってもなくてもいいもの）
オプショナルな設定ファイル

4. `include_once`

include_once 'optional-config.php';

特徴：

ファイルが見つからない場合、Warning
既に読み込み済みなら再読み込みしない

メリット：

✅ 二重読み込み防止 + エラーでも続行

デメリット：

❌ 必須ファイルには不向き

適したケース：

オプショナルなプラグイン読み込み
カスタマイズファイル（存在しないこともある）

比較表：どれを使うべきか

方法	エラー時の挙動	二重読み込み防止	推奨度	用途
`require`	Fatal Error	❌	⭐⭐	シンプルな小規模プロジェクト
`require_once`	Fatal Error	✅	⭐⭐⭐⭐⭐	ほぼ全てのケース
`include`	Warning	❌	⭐	テンプレートパーツ
`include_once`	Warning	✅	⭐⭐	オプショナルファイル

結論：迷ったら require_once を使いましょう！

パス指定の方法7選

方法1: 相対パス（`DIR` 基準）

// admin/login.php から initialize.php を読み込む
require_once __DIR__ . '/../initialize.php';

// fm/request/index.php から（2階層上）
require_once __DIR__ . '/../../initialize.php';

メリット：

✅ ファイルの場所が明確
✅ 移植性が高い

デメリット：

❌ ディレクトリ構造が変わると全て書き換え必要
❌ 深い階層だと ../../.. が読みにくい

適したケース：

シンプルなプロジェクト
ディレクトリ構造が固定されている場合

方法2: `$_SERVER['DOCUMENT_ROOT']` + 絶対パス

// ドキュメントルートからの絶対パス
require_once $_SERVER['DOCUMENT_ROOT'] . '/child-site/php-form/initialize.php';

// 別のサイト構造でも
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

メリット：

✅ 一括置換で簡単に変更可能
✅ どのファイルからでも同じパス
✅ エディタの検索機能で全置換できる

デメリット：

❌ サーバー移行時にパス変更が必要

適したケース：

中〜大規模プロジェクト（最推奨）
複数サイトで同じコードを使う場合
ディレクトリ構造が変わる可能性がある場合

実例：

// 本番環境
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

// サブディレクトリ運用時も一括置換で対応
require_once $_SERVER['DOCUMENT_ROOT'] . '/sub-directory/php-form/initialize.php';

方法3: 定数を使った方法

// 最初に定義
define('PROJECT_ROOT', __DIR__);

// 各ファイルから
require_once PROJECT_ROOT . '/config/database.php';
require_once PROJECT_ROOT . '/helpers/functions.php';

メリット：

✅ 可読性が高い
✅ 変更が1箇所で済む

デメリット：

❌ 定数を先に定義する必要がある

適したケース：

フレームワーク開発
大規模プロジェクト

方法4: `glob()` でファイル検索（非推奨）

// 親ディレクトリを遡って検索
$pattern = __DIR__ . '/../initialize.php';
$files = glob($pattern);

if (!empty($files)) {
    require_once $files[0];
}

メリット：

✅ 柔軟にファイルを探せる

デメリット：

❌ 意図しないファイルを読み込むリスク
❌ パフォーマンスが悪い
❌ 複数の同名ファイルがある場合、誤検出

適したケース：

❌ 基本的に推奨しない

方法5: 環境変数を使う

// .env や環境変数で定義
// APP_ROOT=/var/www/html/myapp

require_once getenv('APP_ROOT') . '/config/app.php';

メリット：

✅ 環境ごとに異なるパス設定が可能
✅ セキュリティ面で優れている

デメリット：

❌ 環境変数の設定が必要

適したケース：

Docker環境
本番/開発環境で異なるパス構成

方法6: Composer Autoload

// composer.json に設定
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

// 自動読み込み
require 'vendor/autoload.php';

use App\Models\User;  // 自動で src/Models/User.php を読み込む

メリット：

✅ モダンなPHP開発のスタンダード
✅ クラスを使うときだけ読み込む（遅延読み込み）
✅ 手動でrequireする必要がない

デメリット：

❌ Composerが必要

適したケース：

モダンPHP開発（Laravel, Symfony等）
PSR-4準拠のプロジェクト

方法7: カスタムオートローダー

// オートローダー登録
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/classes/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require_once $file;
    }
});

// クラスを使うと自動読み込み
$user = new User();  // classes/User.php が自動読み込み

メリット：

✅ Composer不要で自動読み込み
✅ 必要なファイルだけ読み込む

デメリット：

❌ 自分でオートローダーを実装・メンテナンス

適したケース：

Composerを使えない環境
軽量なフレームワーク開発

パス指定方法の比較表

方法	保守性	移植性	安全性	推奨度
相対パス（`__DIR__`）	⭐⭐	⭐⭐⭐	⭐⭐⭐	⭐⭐
`$_SERVER['DOCUMENT_ROOT']`	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
定数	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐
`glob()` 検索	⭐	⭐⭐	⭐	❌
環境変数	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
Composer Autoload	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐
カスタムオートローダー	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐

プロジェクト構造別のベストプラクティス

ケース1: シンプルな小規模サイト

/
├─ index.php
├─ config.php
├─ functions.php
└─ pages/
   ├─ about.php
   └─ contact.php

推奨：相対パス（__DIR__）

// index.php
require_once __DIR__ . '/config.php';
require_once __DIR__ . '/functions.php';

// pages/about.php
require_once __DIR__ . '/../config.php';

ケース2: 中規模フォームシステム

/child-site/php-form/
├─ initialize.php
├─ admin/
│  └─ login.php
└─ fm/
   └─ request/
      └─ index.php

推奨：$_SERVER['DOCUMENT_ROOT'] + 絶対パス

// admin/login.php
require_once $_SERVER['DOCUMENT_ROOT'] . '/child-site/php-form/initialize.php';

// fm/request/index.php
require_once $_SERVER['DOCUMENT_ROOT'] . '/child-site/php-form/initialize.php';

メリット：サイト構造が変わっても一括置換で対応

// サイト構造変更後も一括置換で対応
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

ケース3: 複数サイトで同じコードを使う

# サイトA
/php-form/initialize.php

# サイトB
/company/php-form/initialize.php

# サイトC（支店）
/branch/php-form/initialize.php

推奨：$_SERVER['DOCUMENT_ROOT'] + サイト別パス

// サイトA
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

// サイトB（一括置換）
require_once $_SERVER['DOCUMENT_ROOT'] . '/company/php-form/initialize.php';

// サイトC（一括置換）
require_once $_SERVER['DOCUMENT_ROOT'] . '/branch/php-form/initialize.php';

ケース4: モダンPHPフレームワーク（Laravel等）

/
├─ composer.json
├─ vendor/
├─ app/
│  ├─ Models/
│  └─ Controllers/
└─ public/
   └─ index.php

推奨：Composer Autoload

// public/index.php
require __DIR__ . '/../vendor/autoload.php';

// 以降、クラスは自動読み込み
use App\Models\User;
use App\Controllers\UserController;

実践例：WordPressの読み込み構造分析

WordPressがどのようにファイルを読み込んでいるか見てみましょう。

読み込みフロー

index.php
  ↓
wp-blog-header.php
  ↓
wp-load.php
  ↓
wp-config.php
  ↓
wp-settings.php
  ↓
functions.php（テーマ）

実際のコード

index.php:

<?php
define('WP_USE_THEMES', true);
require __DIR__ . '/wp-blog-header.php';

wp-blog-header.php:

<?php
require_once __DIR__ . '/wp-load.php';
wp();
require_once ABSPATH . WPINC . '/template-loader.php';

wp-load.php:

<?php
define('ABSPATH', __DIR__ . '/');

if (file_exists(ABSPATH . 'wp-config.php')) {
    require_once ABSPATH . 'wp-config.php';
}

学べるポイント：

✅ __DIR__ で確実にパス取得
✅ define() で定数化して再利用
✅ file_exists() でファイル存在チェック
✅ require_once で二重読み込み防止

よくある落とし穴と解決策

落とし穴1: 二重読み込みによる関数再定義エラー

NG例：

// functions.php
function get_user_name() {
    return "John";
}

// index.php
require 'functions.php';
require 'functions.php';  // Fatal error: Cannot redeclare get_user_name()

解決策：

// require_once を使う
require_once 'functions.php';
require_once 'functions.php';  // ✅ 2回目は無視される

// または、関数定義時にチェック
if (!function_exists('get_user_name')) {
    function get_user_name() {
        return "John";
    }
}

落とし穴2: 相対パスの階層間違い

NG例：

// admin/reports/monthly.php から initialize.php を読み込み
require_once '../../initialize.php';  // 階層数を間違えやすい

解決策：

// $_SERVER['DOCUMENT_ROOT'] を使う
require_once $_SERVER['DOCUMENT_ROOT'] . '/php-form/initialize.php';

// または定数を使う
require_once ESTFM_PATH . '/config/database.php';

落とし穴3: glob() による誤検出

NG例：

// 複数の initialize.php が存在する場合
/php-form/initialize.php
/branch-office/php-form/initialize.php

// 意図しないファイルを読み込む可能性
$files = glob('*/php-form/initialize.php');
require_once $files[0];  // どっちが読み込まれる？

解決策：

// 明示的にパス指定
require_once $_SERVER['DOCUMENT_ROOT'] . '/branch-office/php-form/initialize.php';

まとめ：

PHPのファイル読み込みは、プロジェクトの規模や構造によって最適な方法が異なります。

基本原則：

迷ったら require_once + $_SERVER['DOCUMENT_ROOT']
モダンPHPなら Composer Autoload
相対パスは小規模プロジェクトのみ
明示的で保守しやすいコードを心がける

この記事が、PHPプロジェクトのファイル読み込み設計の参考になれば幸いです。

CODE PLUS

WordPressサイトでのPDFダウンロード追跡：GA4とサーバーサイドトラッキングの実装

Sunoのプロンプトが200文字までなので、DeepL API & 文字数カウンターを作ってみた

WordPressからPHP工房のメールフォームへの移行・カスタマイズ

Pythonの「FontTools」で、font-feature-settingが効くフォントのサブセット化

SVGアニメーションをGIFに変換するPythonツール【他のツールで失敗した動的SVGも対応】

URLパラメータで配列を渡す3つの方法と、WAFで真っ白になる問題の解決策

PHPでCSRF対策を実装する方法｜CSRFトークンの生成・検証・エラー・デバッグ方法まで徹底解説

PHPでファイルを読み込む方法：require, include, autoloadの使い分け

PHPでファイルを読み込む方法：
require, include, autoloadの使い分け

基本的なファイル読み込み方法4つ

1. `require`

2. `require_once`（最もよく使われる）

3. `include`

4. `include_once`

比較表：どれを使うべきか

パス指定の方法7選

方法1: 相対パス（`DIR` 基準）

方法2: `$_SERVER['DOCUMENT_ROOT']` + 絶対パス

方法3: 定数を使った方法

方法4: `glob()` でファイル検索（非推奨）

方法5: 環境変数を使う

方法6: Composer Autoload

方法7: カスタムオートローダー

パス指定方法の比較表

プロジェクト構造別のベストプラクティス

ケース1: シンプルな小規模サイト

ケース2: 中規模フォームシステム

ケース3: 複数サイトで同じコードを使う

ケース4: モダンPHPフレームワーク（Laravel等）

実践例：WordPressの読み込み構造分析

読み込みフロー

実際のコード

よくある落とし穴と解決策

落とし穴1: 二重読み込みによる関数再定義エラー

落とし穴2: 相対パスの階層間違い

落とし穴3: glob() による誤検出

まとめ：

will-changeとtransform: translateZ(0)の落とし…

Noto Sans JPのボタンがズレる原因と解決法

PHPでファイルを読み込む方法：require, include, autoloadの使い分け

基本的なファイル読み込み方法4つ

1. require

2. require_once（最もよく使われる）

3. include

4. include_once

比較表：どれを使うべきか

パス指定の方法7選

方法1: 相対パス（__DIR__ 基準）

方法2: $_SERVER['DOCUMENT_ROOT'] + 絶対パス

方法3: 定数を使った方法

方法4: glob() でファイル検索（非推奨）

方法5: 環境変数を使う

方法6: Composer Autoload

方法7: カスタムオートローダー

パス指定方法の比較表

プロジェクト構造別のベストプラクティス

ケース1: シンプルな小規模サイト

ケース2: 中規模フォームシステム

ケース3: 複数サイトで同じコードを使う

ケース4: モダンPHPフレームワーク（Laravel等）

実践例：WordPressの読み込み構造分析

読み込みフロー

実際のコード

よくある落とし穴と解決策

落とし穴1: 二重読み込みによる関数再定義エラー

落とし穴2: 相対パスの階層間違い

落とし穴3: glob() による誤検出

まとめ：

will-changeとtransform: translateZ(0)の落とし…

Noto Sans JPのボタンがズレる原因と解決法

PHPでファイルを読み込む方法：
require, include, autoloadの使い分け

1. `require`

2. `require_once`（最もよく使われる）

3. `include`

4. `include_once`

方法1: 相対パス（`DIR` 基準）

方法2: `$_SERVER['DOCUMENT_ROOT']` + 絶対パス

方法4: `glob()` でファイル検索（非推奨）