zentaophp框架手册.docx

zentaoPHP框架手册目录1、框架介绍 31.1、关于zentaoPHP框架 31.1.1、zentaoPHP框架的缘起 31.1.2、zentaophp框架的特点 31.2、 zentaophp框架的主要功能 41.2.1、单一入口模式 41.2.2、MVC模式 41.2.3、支持GET和PATH_INFO两种方式调用 51.2.4、内置数据库访问层DAO 51.2.5、支持跨模块之间的调用 51.2.6、无需路由配置，即可获得简捷的URL 51.2.7、灵活的数据验证机制 61.2.8、配置和语言可以通过对象方式引用 61.2.9、方便的全局变量应用 61.2.10、所见即API 61.2.11、内置多语言支持 61.2.12、强大的扩展机制 61.3、 zentaophp框架授权协议 72、框架安装 72.1、zentaoPHP框架系统要求 72.2、zentaoPHP框架安装 82.2.1、安装apache, mysql, php的运行环境 82.2.2、获取最新的zentaoPHP框架 82.2.3、安装zentaoPHP框架 82.2.4、建立demo数据库 82.2.5、生成配置文件 82.2.6、访问demo应用 93、快速入门 103.1、 简单的Hello world! 103.1.1、了解框架目录结构 103.1.2、创建hello模块 113.1.3、创建control.php文件 113.1.4、访问helloworld应用 113.2、使用MVC实现的hello world! 113.2.1、仅有control.php的hello world. 123.2.2、有model层的hello world. 123.2.3、带有view层的hello world. 133.3、部署框架自带的简单的blog示例 143.3.1、创建数据库 143.3.2、创建应用的配置文件 153.3.3、访问blog应用 154、框架基础 164.1、 zentaoPHP框架里面的基本概念 164.1.1、router 164.1.2、app 174.1.3、config, lang, dbh 174.1.4、URI，module，control, model and view 174.2、 zentaoPHP框架的两种请求方式 184.2.1、传统GET方式 184.2.2、静态友好方式 184.3、如何生成链接 194.3.1、$this->createLink()方法 194.3.2、helper::createLink()方法 204.3.3、JS版本的createLink()方法 204.4、 框架里面提供的html, js和css类 204.4.1、html类 204.4.2、JS类 214.4.3、css类 225、深入框架 225.1、 zentaoPHP目录结构 225.1.1、顶级目录结构 225.1.2、具体到一个模块的目录结构 225.2、 zentaoPHP框架提供的DAO功能 235.2.1、关于DAO的说明 235.2.2、执行方法的区别 235.2.3、操作符说明 245.2.4、查询语句： 245.2.5、插入语句 255.2.6、更新语句 265.2.7、REPLACE语句 265.2.8、删除语句 265.3、 zentaoPHP框架的分页解决方案 275.3.1、browse方法关于分页的三个参数 275.3.2、model方法中调用pager对象 275.3.3、control中将pager对象赋值给模板 285.4、 zentaoPHP框架中的数据验证机制 285.4.1、验证规则放在什么地方？ 295.4.2、zentaoPHP框架验证机制说明 295.4.3、数据修正 295.4.4、数据检查 305.4.5、获得错误 315.4.6、数据修正和数据检查方法附录 311、框架介绍1.1、关于zentaoPHP框架1.1.1、zentaoPHP框架的缘起2009年我们决定开始启动禅道项目管理软件的开发，编程语言自然选择了一直使用的PHP。

但在开发框架的选择上，颇费了一番功夫09年的时候，php5.2系列的版本oop的功能已经比较强大，市面上也出现了一大批的框架比如cakephp, symfony, zend framework, codeignightor等等仔细的研究这些框架之后，最符合我们要求的是codeignightor这个框架，概念简单，文档丰富但遗憾的是这个框架是基于php4面向过程的语法实现的，导致它的很多实现并不是很合理考虑到我们后续产品的发展，我们决定自己来开发一款框架于是2009年3月1日，发布了第一个版本1.1.2、zentaophp框架的特点zentaophp框架的定位主要是b/s架构的应用开发，它不是一款全能型的框架，主要的目的还是服务我们团队自己的产品研发因此和其他的框架相比，它有很强的特点：（1）代码简单框架的核心只有四个文件，分别为调度类router.class.php，control类control.class.php，model类model.class.php和工具类helper.class.php代码的实现也比较简单，有能力的开发者可以很容易在框架基础上进行扩展，增加自己的功能2）性能良好zentaoPHP框架在实现过程中，十分重视性能。

在保证功能的前提下面，尽可能的提升程序执行效率3）结构清晰使用ZenTaoPHP框架来开发应用，其目录结构简单清晰，维护起来非常的方便4）开发友好框架，首先是一个框，把你框在了里面所以很多框架会有很多的约定，你要怎样，你要怎样还有很多隐形的约定，比如你要在你的代码里面写很多的xxxx之类的东东我觉得一个好的框架在实现功能的前提下，应当尽量兼顾开发人员之前的开发习惯，所以zentaoPHP框架在这方面花了大量的力气：（5）中性命名：框架实现时，没有出现什么zentao之类的命名，完全是中性的命名：router, control, model, config, lang6）配置对象化： 配置项可以通过对象的方式来引用，$config->db->user，要比$config['db']['user']简洁顺畅的多7）相对路径包含：所有的路径都可以用相对路径来进行包含，这样可以很清晰的知道目录结构和代码之间的关系1.2、 zentaophp框架的主要功能zentaoPHP框架的主要功能如下：1.2.1、单一入口模式单一入口是现在比较流行的开发方式好处在于可以有一个集中的控制或者讲框架一个比较基本的东西也是单一入口吧。

现在ZenTaoPHP框架支持web方式和命令行方式的两种入口文件具体的例子大家可以查看app目录下面的demo/www/index.php和cli/call这两个文件1.2.2、MVC模式ZenTaoPHP支持MVC方式的开发不过相比较于其他框架的多种模板实现来讲，ZenTaoPHP并没有尝试去开发一套新的模板系统，而是采用PHP作为模板语言这是最快的一种解决方案，而且也是最简洁的一种方案1.2.3、支持GET和PATH_INFO两种方式调用支持  index.php?m=user&f=info&id=123这种GET方式的调用，也支持 /user/info/123.html 这种方式的调用如果你能控制你的运行环境，可以使用PATH_INFO的方式，这样生成的URL地址更加简捷，而且对搜索引擎十分友好1.2.4、内置数据库访问层DAO禅道框架内置了DAO数据库访问层，在PDO的基础上，提供了完整的SQL拼装功能，可以非常方便的书写SQL查询语句，获取数据而且我们在实现DAO的时候，花了很大的力气在兼容之前大家手写SQL的习惯，所以大家在使用禅道框架的DAO的时候，会发现很亲切，因为和手写SQL基本上是相同的。

1.2.5、支持跨模块之间的调用在ZenTaoPHP框架中，一个模块的control或者model都可以直接调用另外一个模块的model，这样就可以将一个应用进行模块化，然后通过采用不同模块的功能，来实现比较复杂的功能除了model的调用之外，一个模块的control还可以fetch另外一个模块的control方法，这种一般用于一些共用的页面元素，比如打印一个搜索表单，或者打印菜单等等通过control之间的互相调用，实现代码的共享1.2.6、无需路由配置，即可获得简捷的URLZenTaoPHP框架提供了简洁的参数传递方式比如user模块有一个read方法，需要id和name两个参数，通常的PATH_INFO为user/read/id/1/name/wwccss.html，而zentaoPHP支持user/read/1/wwccss.html的形式，这样就省略了参数名的传递这一切，都不需要配置任何的路由，直接通过框架的功能就可以获得1.2.7、灵活的数据验证机制禅道PHP框架内置了灵活的数据验证机制，可以实现对数据的修正和检查，代码极其紧凑，简洁1.2.8、配置和语言可以通过对象方式引用zentaoPHP框架的配置没有用什么ini文件，也没有用什么yaml文件，也没有用php的数组，而是直接用PHP对象的形式。

这样配置文件不需要解析，就可以直接使用，而且引用起来十分的方便形如$config->db->host的这种方式，而不是$config['db']['host']的这种方式书写起来会非常的流畅！1.2.9、方便的全局变量应用在zentaoPHP框架中，引用GET，POST, SERVER这样的全局变量，可以通过这样的方式：$this->get->userName, $this->post->userName, $this->server->remote_addr1.2.10、所见即API在现在开放平台的潮流下面，有一个非常好的api机制是比较重要的在zentaoPHP框架中，每一个接口都可以成为api至于api的方式，是通过其访问的扩展名来加以区分比如如果你访问的是user/read/id/123.html，那么返回的是正常的网页如果访问的是user/read/id/123.json，那么返回的就是json格式的数据1.2.11、内置多语言支持zentaoPHP框架支持多种语言功能，会自动根据当前用户客户端的信息来判断使用何种语言，这样可以方便大家开发多语言的应用1.2.12、强大的扩展机制zentaoPHP框架实现了强大的扩展机制。

通过这套扩展机制，做定制开发可以说是轻而易举，再也不用担心维护多个分支带来的痛苦了1.3、 zentaophp框架授权协议zentaoPHP框架最开始的授权协议是LGPLLGPL协议对大家的使用还是有一些限制的，尤其是对一些商用所以我们做了一个决定，从2.1版本开始，彻底将zentaoPHP代码的版权捐献出来，以public domain协议发布！简单来讲，任何人或者任何单位可以用ZenTaoPHP框架做任何的使用，而没有任何的限制包括重新发布，改名，商用，等等/*** The control class file of zentaoPHP framework.** The author disclaims。