EclipsePHP 创建 PHP 类需手动创建文件并补全命名空间与类声明，因无原生“New PHP Class”向导；必须确保文件名、类名、命名空间、目录路径四者严格一致，否则导致自动加载失败、IDE 导航失效等问题。
在 EclipsePHP 中创建类文件，本质是新建一个符合 PHP 命名规范和 PSR-4（或项目约定）结构的 .php 文件，并手动/辅助补全类声明。EclipsePHP 本身没有“New PHP Class”向导（不像 Java 那样原生支持），所以必须通过文件模板 + 手动编写来实现，否则容易出现命名不一致、命名空间错误、自动加载失败等问题。
为什么不能直接用 “New → PHP File” 就完事？
直接新建空 .php 文件后，如果不手动写 class 声明、namespace 和 autoload 兼容结构，会导致：
- 代码补全失效（Eclipse 无法识别该文件为类定义）
- Ctrl+Click 跳转到类失败
- Composer 自动加载找不到类（尤其当文件名与类名不匹配时）
- 静态分析工具（如 PHPStan）报
Class not found
正确创建 PHP 类文件的三步操作
以创建 UserController 类为例（位于 src/Http/Controllers 目录下）：
-
步骤 1：右键目标文件夹 →
New → PHP File，输入文件名（必须与类名一致，如UserController.php） - 步骤 2：打开新文件，在顶部手动添加标准声明 —— 注意顺序：编码声明、命名空间、类定义
-
步骤 3：确认文件路径与命名空间匹配（例如文件在
src/Http/Controllers/UserController.php，则命名空间应为App\Http\Controllers）
如何让 EclipsePHP 自动补全 class 模板？
Eclipse 支持自定义 PHP 文件模板，避免每次手敲
namespace和class结构：立即学习“PHP免费学习笔记（深入）”；
- 进入
Window → Preferences → PHP → Editor → Templates - 点击
New...，名称填php_class，内容填：
- 在编辑器中新建
.php文件后，输入php_class+Ctrl+Space即可触发模板插入，${namespace}和${class_name}会高亮可编辑
常见错误与修复建议
实际操作中最容易卡住的几个点：
-
Parse error: syntax error, unexpected 'class' (T_CLASS)→ 文件开头有多余 BOM 或空格；检查是否用了 UTF-8 with BOM 编码，改用UTF-8 without BOM - 类名首字母未大写（如
usercontroller.php）→ Composer PSR-4 加载器严格区分大小写，Linux 环境下直接失败 - 命名空间末尾多了一个反斜杠（如
namespace App\Http\Controllers\;）→ PHP 语法错误，删除末尾\ - Eclipse 不识别新增类 → 右键项目 →
Refresh，再执行Project → Clean...强制重建索引
真正麻烦的不是建文件，而是让文件名、类名、命名空间、目录路径四者对齐——少错一个，后续 autoload、IDE 导航、测试运行都会出问题。
