php 出现 class not found 错误通常是因为自动加载器（autoloader）未能将类名映射到正确的文件路径。解决方向是检查命名空间声明、文件路径大小写以及 composer 的 autoload 配置。适用条件为使用 psr-4 标准的项目结构，且依赖管理工具为 composer。
目录结构与命名空间映射
PSR-4 标准要求命名空间前缀与目录层级严格对应。若命名空间为 AppModels，则文件必须位于 src/Models/ 目录下，且文件名需与类名一致。以下是最小化项目结构示例：
// composer.json
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
执行 composer dump-autoload 后，Composer 会生成 vendor/autoload.php。在入口文件引入该文件即可启用自动加载。若类仍找不到，检查 src/ 下是否存在对应的 PHP 文件，且文件名首字母大写，如 User.php。
常见分支：大小写敏感问题
Linux 系统对文件名大小写敏感，而 Windows 不敏感。若代码中引用 AppUser，但文件名为 user.php，在 Linux 服务器上会报错。需确保文件名与类名完全一致，包括大小写。
<?php require_once 'vendor/autoload.php';
use AppUser;
try {
$user = new User();
echo get_class($user);
} catch (Error $e) {
echo 'Class not found: ' . $e->getMessage();
}
?>
运行上述脚本，若输出 AppUser 表示成功。若抛出异常，检查 src/User.php 是否存在，且第一行是否为 namespace App;。同时确认 composer.json 中的路径是否拼写正确。
验证与实际边界
验证方法是通过命令行运行 PHP 脚本，观察是否抛出 Class 'AppUser' not found。实际边界在于：若使用框架（如 Laravel），其内置自动加载可能覆盖 Composer 配置；若手动实现 spl_autoload_register，需确保回调函数能正确解析类名并 include 文件。此外，OPcache 缓存可能导致旧错误持续显示，需重启 Web 服务器或清除缓存。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
