PHP: Fatal error: Class not found

概要

PHPでクラスが見つからない場合に発生するFatal errorです。

エラーメッセージ

PHP Fatal error: Uncaught Error: Class 'App\Services\UserService' not found

原因

1. オートロード未設定: Composerのautoloadが設定されていない
2. 名前空間の不一致: ファイルパスと名前空間が一致しない
3. requireの忘れ: ファイルが読み込まれていない

解決策

1. Composerのautoload設定

1
2
3
4
5
6
7

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

1

composer dump-autoload

2. 名前空間とディレクトリ構造を一致させる

src/
  Services/
    UserService.php  # namespace App\Services;

3. autoloadの読み込み

1

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

よくある間違い

• composer dump-autoloadの実行忘れ
• 大文字小文字の不一致（Linux環境）