![](/theme/default/default/images/main/icon-menu.png)
![](/theme/default/default/images/main/icon-close-2x.png)
![](https://cdn.easycorp.cn/web/data/upload/zentao/202402/f_0c7d40c83be2425f404dc4bd5ee778cb.png)
- 1 zentaoPHP二次开发简介
- 2. zentaoPHP框架扩展机制
- 2.1 扩展机制简介
- 2.2 新增独立模块
- 2.3 对控制层(control)扩展
- 2.4 对模型层(model)扩展
- 2.5 对视图层(view)扩展
- 2.6 对样式表和js进行扩展
- 2.7 对语言配置进行扩展
- 2.8 增加新的类库
- 3. zentaoPHP框架API机制
- 3.1 api机制简介
- 3.2 需要登录验证的api调用
- 4 zentaoPHP框架命令行机制
对模型层(model)扩展 分享链接
本篇目录
model为模型方法,主要用来处理各种数据的查询、更新。model的扩展分为三种方式,一种是直接新增或者覆盖方法,一种是通过钩子来实现,第三种则是完全定义一个新的类,下面分别来讲述下各自实现的机制。
一、直接新增或者覆盖方法
不管是新增方法还是覆盖现有的方法,都是在模块的ext/model/目录下面建立相应的以方法为名的文件。比如,我们打算对misc的model新增一个方法,叫做foo,那么只需要在misc/ext/model/下面建立foo.php,代码如下:
public function foo() { return 'foo'; }需要说明的是这里面的定义不包含类的声明,就只是一个方法的声明。禅道框架在执行的时候,会自动将扩展目录下面的foo.php里面的代码,替换misc/model.php中的foo方法的代码。如果是新增的方法,则会追加到misc/model.php的代码中,最终生成一个合并之后的model类文件。
二、通过钩子来扩展
除了新增或者覆盖方法之外,还可以通过钩子方式来扩展。所有的钩子都是存放在ext/model/hook目录下面,文件命名规则是:方法名.扩展名.php
比如我对misc模块中的helllo方法进行钩子的扩展,在misc/ext/model/hook/下面创建hello.abc.php的文件,然后在里面实现代码就可以了。
禅道框架会把某一个方法的所有的钩子代码合并到终的代码中。
不过这种方法有很多限制,会有意想不到的行为,不建议大家使用。
三、通过类的方式来扩展
除了上面两种方式之外,model的扩展还有第三种方式,就是将所有的扩展放在一个类里面,然后通过框架的loadExtension()方法来加载。这种主要是为了解决加密文件冲突的问题。zentaoPHP框架在处理model的扩展时,会把相应的代码进行合并,但这时候问题就来了。如果对第一种方法的扩展,也就是exe/model/abc.php进行加密,就会和其他的开源的model扩展冲突。如果不加密,无法保护作者的代码。为了解决这个问题,我们特地实现了第三种扩展方法,下面我们来说明下:
3.1 在ext/model/class/下面创建一个类,文件名的规则是插件名.class.php。
比如我们的甘特图插件,定义为project/ext/model/class/gantt.class.php,里面定义各种代码。
类名规则是{插件名}{模块名},模块名首字母大写,如ganttProject。
class ganttProject extends projectModel { public function createRelationOfTasks($projectID) { } }
注意:这个地方类是继承自projectModel,这样还可以重用原来的代码。
public function createRelationOfTasks($projectID) { $this->loadExtension('gantt')->createRelationOfTasks($projectID); }通过loadExtension()方法来调用3.1里面调用的gantt.class.php里面的方法。
这样禅道框架只需要对所有的class扩展进行加密就可以了,就可以解决加密文件冲突的问题了。
注意:本文档是针对禅道16.5版本之前的zentaoPHP框架,禅道最新版本的二次开发文档请参照新版:
https://devel.easycorp.cn/book/extension-new/intro-52.html