PHP框架使用说明.doc

框架使用说明l 如何配置框架并运行1、框架需要运行必须满足1个基本条件（PHP版本为PHP5.X）和一个可选条件（服务器支持重写（显示完美的URL，很静态页面生成）。2、除此之外，第一次使用本框架你还必须进行必要的配置：A、修改.htaccess文件。让文件定向到正确的目录（如果你是在更目录下调试就不必修改这里），其内容如下：RewriteEngine on #开启重写引擎RewriteCond %REQUEST_FILENAME !-f #如果存在静态页面，直接显示静态页面RewriteCond $1 !(index.php|banner|system|application|images|icons|up_files|js|robots.txt) #排除上面的目录和文件（这些文件和目录都不进行重写操作）RewriteRule (.*)$ /index.php/$1 L #这里是关键（将符合规则的页面都重定向处理）B、导入基本数据库，将document/database下面的数据库导如数据库。C、修改系统配置文件（application/config/Config.config.php），其文件如下： 快速建站, /站点名称default_lang = chinese, /默认语言种类base_url = /, /基本访问路径index_page = , /如果服务器不支持重写，请在这里设置为程序入口文件，如：“index.php”mysql = array( /mysql数据库配置hostname = localhost,user = root,passwd = root,database = sf, /使用的数据库名),router = array(default_controller = admin/login, /默认处理控制器default_method = index, /默认处理方法),),);?如果你按照上面的步骤做完了，那么你现在就可以使用“http:/ localhost/”来访问页面了，现在系统应该会显示出欢迎页面。l 框架的目录说明Application /程序开发目录|- config /配置文件目录|- controller/控制器文件目录|- error/系统报错调试页面模板目录|- helper/助手文件目录|- language /语言文件目录|- lib /类库文件目录|- model /数据模型文件目录|- plugins /插件文件目录|- view/视图文件目录System /系统文件目录|- sf /框架核心文件目录|- config /配置文件目录|- controller/控制器文件目录|- error/系统报错调试页面模板目录|- helper/助手文件目录|- language /语言文件目录|- lib /类库文件目录|- model /数据模型文件目录|- plugins /插件文件目录|- view/视图文件目录Document /文档目录|- database /基础数据库目录Images /图片目录Js /javascript目录up_files /上传文件目录.htaccess /重写文件index.php /程序入口文件本框架中system与Application目录结构基本一致，可以认为system目录是Application目录的备份，因为，Application中的文件优先权大于system，只有Application中找不到指定的文件的时候，框架才会去搜索system目录。l 如何编写第一个PHP程序本框架是个多用途框架，他目前支援2种开发方式，那就是：MVC编程和一般顺序编程。框架默认使用MVC编程。我们现在以开发一个简单的留言板为例进行说明。创建数据模型。当然这个不是必要的，你也可以省略这步直接从下一步开始编写一个不需要数据库参与的传统意义上的Hello word! J你首先需要在数据库中创建一个数据表BOOK，它有4个字段，如：subject（标题），content（内容），created_at(留言时间)，response(回复)。如果你知道数据库是什么那请自行创建，否则，请执行以下的MYSQL命令：CREATE TABLE pzsfjrmtjglxt.book (id INT(11)NOTNULLAUTO_INCREMENT,subject VARCHAR(60)NULL,content TEXTNULL,response TEXTNULL,created_at DATETIME NULL ,PRIMARY KEY ( id ) ENGINE = MYISAM请访问“http:/ localhost/tools”（这是系统的一个数据模型生成工具），你就会看到你刚才创建的数据表，你选中它执行就完成了数据模型的创建。当然，你创建之后有对数据库有了新的修改，那么，你需要再次进行这样的操作，TOOLS会重新生成数据模型。（/tcc/tools）只要数据模型创建成功，你就可以在任何时候任何地点用“sf:getModel(“book”)”这样的方式来取得这个数据模型对象。按照需要创建控制器。控制（器）其是一个程序或者说是一个页面的基本组成部分，是核心和灵魂，我们这个框架所谓的程序设计一般指控制器设计（当然也有所谓的开发，它是指对类库、助手和插件的拓展和开发，这个属于“高科技”）。在application/controller/目录下创建一个控制器类guestbook并命名为“guestbook.php”,其内容如下：getPager($addWhere,$addSql,5); /每页显示5条记录view:display(index);/显示“index”视图1lllll1111111111/* 插入留言*/function edit()$book = sf:getModel(book); 或者：$book = sf:getModel(book,input:getInput(post.id) ? input:getInput(post.id) : input:getInput(get.id); /取得数据模型对象，如果你需要修改ID为3的留言记录，这里你可以这样写：$book = sf:getModel(book，3);如果这里稍微做些修改，你会发现修改和增加其实都可以使用这个方法。：-）if(input:getInput(post.content) /判断是否有内容输入$book-setSubject(input:getInput(post.subject);/设置留言标题$book-setContent(input:getInput(post.content);/设置留言内容$book-setCreatedAt(date(Y-m-d H:i:s);/设置留言时间If（$book-save()） /保存留言$this-page_debug(lang:get(Has been saved!),getFromUrl();（-$this-page_debug(lang:get(Has been saved!),site_url(admin/guestbook/index);-固定指向一个页面）view:set(book,$book);/将book对象与视图关联view:display(edit);/显示“edit”视图?创建视图文件。按照控制器和你的需要创建视图文件，当然，这一步也不是必须的！不过，我们在大多数时候是需要的。在“application/view”中创建视图文件“edit.php”，其内容如下：留言板 form name=bookform id=bookform action= method=post 留言标题 input name=subject type=text id=subject size=60 value=”getSubject()?” / 留言内容 getContent()? input name=id type=hidden id=id value=getId()? / 在“application/iew”中创建视图文件“index.php”，其内容如下:留言板-列表 form name=bookform id=bookform action= method=post 关键词 input type=button name=button2 id=button2 value= 留 言 onclick=window.location.href= / getObject():? getSubject()?getContent()? fromto().$pager-navbar(10)? 如果你按照上面的流程走下来，你应该可以用“http:/ localhost/guestbook/index”来访问你的简单的留言板了。当然回复没有为你演示，聪明的你应该可以很容易的自己设计出来。l 如何使用数据模型在系统的任何地方，你都可以使用sf:getModel(数据库名，主键值)，取得一个数据模型对象，其中，如果提供了正确的“主键值”，你等到的将是一个包含具体记录的数据模型对象，否则，你得到的将是一个空的数据模型对象。如果你对空的数据模型对象设置属性，并调用SAVE方法，你的操作将向数据表中增加一条新的记录。数据模型默认有以下的方法可供使用：属性的取得（getXXX()）和赋予(setXXX()。其中XXX表示数据库中字段名（数据字段首字母大写，如果有”_”则去掉“_”并且将后面紧跟字母大写。如：数据表有字段“created_at”，那么，他便有2个相关的方法getCreatedAt()和setCreatedAt()）。数据选取方法SelectAll(SQL中WHERE拼接内容,SQL中排序和分组内容,最多显示记录数)和getPager(SQL中WHERE拼接内容,SQL中排序和分组内容,最多显示记录数)。前面的2个方法参数一直，功能基本相同，唯一不同的是getPager()返回的翻页对象,翻页对象继承数据集对象，所以，他还可以返回翻页等信息，