mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-08-30 12:45:32 +08:00
600ee5b085
- 删除 tools:agent:publish 整套（不再兼容多套 IDE，只保留 .agents 目录） - helper.php 全部 27 个全局函数加 if (!function_exists()) 包裹，项目侧可在 app/common.php 定义同名函数覆盖 - ulthon-file-override-mechanism.md 新增全局函数覆盖章节 - AGENTS.md 删除智能体指导章节，PHP 8+ 改为 8.0+，MySQL 8+ 改为 5.7+ - AGENTS.md 项目结构树补全 tests/、extend/think/、source/ 子项 - README.md PHP 版本统一为 8.0+ - ulthon-base-app-architecture SKILL 路径补 admin/service/ 段 - ulthon-tools-http-call SKILL 补 --page-data 参数 - ulthon-naming-convention 补元数据头 - ulthon-update-workflow 统一 extend/think/ 归类
22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
# 命名规范
|
||
|
||
> 来源：框架内置（ulthon-）
|
||
> 作用域：所有目录命名与 PHP 文件命名场景
|
||
> 触发条件：新增目录、新增 PHP 文件、命名疑问时加载
|
||
|
||
## 目录命名
|
||
|
||
- 一个单词的目录用小写，例如 `service/`、`controller/`
|
||
- 多个单词的目录用大驼峰，例如独立的子项目目录 `AdminService/`、`UserService/`
|
||
- 此处的"多单词目录"指 **独立子项目目录**（如 `source/` 下各端工程、各子项目目录），**不**指框架标准应用目录
|
||
- 框架标准应用目录（`app/admin/`、`app/common/` 等）按 ThinkPHP 惯例统一使用小写
|
||
- **控制器子目录**：推荐使用全小写命名，例如 `app/admin/controller/system/`、`app/admin/controller/mall/`
|
||
- 即使目录名用了大驼峰，URL 也会自动转换，但默认全小写可避免歧义
|
||
- URL 访问规则详见 [ulthon-controller-url.md](./ulthon-controller-url.md)
|
||
|
||
## PHP 文件命名
|
||
|
||
- **service 模块**：文件名需要写 `Service` 后缀，例如 `AdminService.php`（类名 `AdminService`），而不是 `Admin.php`
|
||
- **其他模块**（controller、model、traits、config、middleware 等）：不需要写后缀，直接使用业务名（如 `User.php`、`Order.php`）
|
||
- **Scheme 类**：文件名采用大驼峰（PascalCase），且必须与类名一致，详见 [ulthon-scheme-definition](../skills/ulthon-scheme-definition/SKILL.md)
|