开发规范
目录和文件
- 目录使用小写和下划线
- 类库以
.class.php
结尾 - 控制器以
.ctrl.php
结尾 - 模型以
.mdl.php
结尾 - 验证器以
.vld.php
结尾 - 函数以
.func.php
结尾 - 配置文件以
.inc.php
结尾 - 语言文件以
.lang.php
结尾 - 模板以
.tpl.php
结尾
类、函数和属性命名
- 类的命名采用驼峰法和下划线(首字母大写),例如
User
、User_Type
- 方法的命名使用驼峰法(首字母小写),例如
getUserName
- 属性的命名使用驼峰法(首字母小写),例如
tableName
、instance
- 函数的命名使用小写字母和下划线(小写字母开头)的方式,例如
get_client_ip
命名空间
- 请勿以 \ 开头
- 应用内的类库统一使用 app 开头,后面跟类库类型,具体如下:
- 控制器 app\ctrl 和模块命名,例如:
namespace app\ctrl\console
- 模型以 app\model 开头,例如:
namespace app\model
- 应用类库以 app\classes 开头,例如:
namespace app\classes
- 验证器以 app\validate 开头,例如:
namespace app\validate
- 分层控制器、分层模型和分层验证器由开发者在上述命名空间下自行定义,例如:
namespace app\ctrl\console\general
- 扩展以 extend 开头,后面跟类库类型,具体如下:
- 插件以 extend\plugin 开头,例如:
namespace extend\plugin
- 其他类库 extend\类库名 开头,例如:
namespace extend\类库名
- 系统内核以 ginkgo 开头,例如:
namespace ginkgo
请注意本手册中的示例代码为了简洁,如无指定类库的命名空间,都表示指的是 ginkgo 命名空间,例如下面的代码:
Config::get('hello');
请自行添加 use ginkgo\Config
或者使用
ginkgo\Config::get('hello');
实例命名
- 实例名称以类型和下划线驼峰法(首字母小写)的方式,例如:
obj_response
、ctrl_user
、mdl_appBelong
- 类实例以 obj_ 开头
- 控制器实例以 ctrl_ 开头
- 模型实例以 mdl_ 开头
- 验证器实例以 vld_ 开头
常量和配置
- 常量以大写字母和下划线命名,例如
GK_PATH
和GK_PATH_APP
- 配置参数以小写字母和下划线命名,例如
url_route_on
和url_convert
数据表和字段
- 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如
ginkgo_user
表和user_name
字段,不建议使用驼峰和中文作为数据表字段命名