自制PHP框架遇PSR4自动加载问题：Composer无法加载指定类

嘿，我来帮你排查这个头疼的自动加载问题！看了你的配置和代码后，发现几个关键的小问题，咱们一个个来修复：

1. 文件名与类名拼写不匹配 #

你的类名是get_template_files_class，但对应的文件名却是get_templates_files_class.php——注意到没？类名里是单数的template，文件名里却多了个s变成templates。PSR-4规范要求文件名必须和类名完全一致（包括拼写、大小写），这绝对是导致找不到类的核心原因之一。

你可以先把文件名改成和类名完全匹配：get_template_files_class.php；更推荐的是遵循PSR-1编码规范，把类名改成大驼峰格式（比如GetTemplateFilesClass），文件名也对应改成GetTemplateFilesClass.php，同时更新命名空间和use语句，这样能从根源上减少这类命名问题。

2. 文件目录结构必须严格匹配命名空间 #

你的composer.json里PSR-4配置是这样的：

"psr-4": {
    "System\\" : "system/libs/"
}

这意味着System\Template命名空间下的类，必须放在system/libs/Template/目录里！

所以你的类文件（不管是修改前还是修改后的），完整路径应该是：/var/www/html/fsib/system/libs/Template/get_template_files_class.php，要是放错了目录，Composer根本找不到它。

3. 修改配置后必须更新Composer自动加载缓存 #

每次调整composer.json或者文件结构后，都得重新生成自动加载文件，不然Composer还是用旧的缓存数据。在项目根目录（也就是composer.json所在的目录）运行这条命令：

composer dump-autoload

或者更简洁的缩写：

composer dump

它会更新vendor/autoload.php和相关缓存，让Composer识别到你的新类。

额外小建议：遵循PSR编码规范 #

虽然不是强制要求，但遵循PSR-1和PSR-4规范能避免很多这类低级错误：

• 类名必须用大驼峰命名（比如GetTemplateFilesClass而非get_template_files_class）
• 文件名必须和类名完全一致（包括大小写）
• 命名空间层级要和目录结构严格对应

按照上面的步骤修复后，你的代码应该就能正常自动加载类了，再也不用手动写include啦！

内容的提问来源于stack exchange，提问作者Leonardo Alfonso Tapia Delgado