视图引入common\helpers\Common类报错‘类未找到’，求解决方法

我之前也碰到过一模一样的类加载失败问题，咱们一步步排查解决：

• 先核对文件路径与命名细节
  这是最容易踩坑的点：

  • 确认文件确实放在common/helpers/目录下，文件名必须是Common.php（注意大小写！Linux/Unix服务器是严格区分大小写的，类名是Common，文件名就得完全对应，不能写成common.php或者Helper.php）
  • 检查命名空间：类里的namespace common\helpers;必须和目录结构完全对应，common目录下的helpers子目录不能拼写错误（比如写成Helper或者helper）

• 验证自动加载配置（针对Yii/Composer项目）
  从命名空间风格看你应该用的是Yii框架，这时候要检查composer.json的自动加载规则：
  确保common目录被包含在PSR-4自动加载配置里，类似这样：

  "autoload": {
      "psr-4": {
          "common\\": "common/",
          "frontend\\": "frontend/",
          "backend\\": "backend/"
      }
  }
  

  要是修改了composer.json，一定要执行composer dump-autoload命令更新自动加载缓存，这一步90%的人都会忘！

• 排查类文件的语法错误
  你代码里的---- ----和----- --- Some other methods--- -----是占位符吧？实际代码里要替换成合法的PHP代码，任何语法错误（比如缺少分号、括号不匹配、非法字符）都会导致类加载失败，表现出来就是“找不到类”。
  可以先把类里的方法简化成最基础的测试代码，比如只保留getCommonHtml的空实现，看看能不能正常加载。

• 手动引入测试定位问题
  如果自动加载还是不行，先手动引入文件测试：

  // 在视图里先手动引入
  require_once Yii::getAlias('@common') . '/helpers/Common.php';
  use common\helpers\Common;
  

  如果这样能正常使用，说明自动加载的配置有问题，回到第二步重新检查composer配置并执行dump-autoload。

• 清理框架缓存
  要是用的Yii框架，试着删除runtime/cache目录下的所有文件，有时候旧的缓存会导致类加载异常。

内容的提问来源于stack exchange，提问作者Prasad Patel