VSCode Intelliphense报PHP0413：自定义Database类无法识别，是否路径配置有误？

常见原因及解决办法： #

• 项目根目录未正确打开
  必须在项目的根目录下打开VSCode，而非单个文件或子目录。比如你的lib文件夹在项目根目录下，就直接打开根目录，否则Intelephense无法解析../lib这类相对路径的文件。

• 配置Intelephense的路径映射
  打开VSCode设置（快捷键Ctrl+,），搜索intelephense.environment.includePaths，点击「编辑 in settings.json」，把你的lib目录添加进去：

  "intelephense.environment.includePaths": [
      "./lib"
  ]
  

  如果用绝对路径，直接填写完整路径即可，比如"/var/www/your-project/lib"。

• 检查类文件的命名规范
  确保Database.php里的类名和文件名严格一致（Linux系统区分大小写），比如文件名是Database.php，类定义必须是class Database { ... }，不能有拼写或大小写错误。

• 重启Intelephense服务
  配置修改后需要重启服务生效：打开命令面板（快捷键Ctrl+Shift+P），输入PHP Intelephense: Restart Server执行即可。

• 匹配PHP版本
  在VSCode设置里搜索intelephense.environment.phpVersion，设置成你项目实际使用的PHP版本（比如7.4、8.1），避免版本兼容问题导致识别失败。

内容的提问来源于stack exchange，提问作者Ken Ingram