ulthon/ulthon_admin
1
0
Fork 0
mirror of https://gitee.com/ulthon/ulthon_admin.git synced 2026-08-30 12:45:32 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
39d01d81751f91c1660be8f76de0b6a6b70724a4
ulthon_admin/.agents/rules/ulthon-naming-convention.md
augushong 600ee5b085 refactor(agents): 删除 tools:agent:publish 命令，补全 helper.php 函数覆盖机制，修正多处文档 bug 
- 删除 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/ 归类
2026-07-21 19:35:28 +08:00

1.4 KiB
Raw Blame History

命名规范

来源：框架内置（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

PHP 文件命名

  • service 模块：文件名需要写 Service 后缀，例如 AdminService.php（类名 AdminService），而不是 Admin.php
  • 其他模块（controller、model、traits、config、middleware 等）：不需要写后缀，直接使用业务名（如 User.php、Order.php）
  • Scheme 类：文件名采用大驼峰（PascalCase），且必须与类名一致，详见 ulthon-scheme-definition