MeWrite Docs

PHP: Fatal error: Class not found

PHPのクラスが見つからないエラーの解決方法

概要

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環境)

PHP の他のエラー

最終更新: 2025-12-09