Hostxpeed
Login Get Started →
Troubleshooting

Fix PHP "Class Not Found"

4 min read
32 views
Jun 10, 2026

Understanding the Error

Fatal error: Class 'ClassName' not found

Common Causes

1. Autoloader Issues (Composer)

# Regenerate autoloader
composer dump-autoload

# Check vendor folder exists
ls -la vendor/

2. Missing Include/Require

// Add the missing include
require_once '/path/to/ClassFile.php';

3. Namespace Issues

// Use full namespace
use Namespace\ClassName;

// Or backslash
$obj = new \Namespace\ClassName();

4. Case Sensitivity

Linux filesystems are case-sensitive:

// File: MyClass.php
class MyClass {}  // Exact case matters

5. Wrong PHP Version

Class may require newer PHP:

php -v
# Upgrade if needed

Debug Steps

# Check if file exists
ls -la /path/to/ClassFile.php

# Check file permissions
stat /path/to/ClassFile.php

# Verify syntax
php -l /path/to/ClassFile.php

WordPress Class Not Found

# Reinstall WordPress core
wp core download --force

# Check plugin compatibility
wp plugin status

Was this article helpful?