开发自己php mvc框架(一)
本教程翻译自john squibb 的build a php mvc framework in an hour,但有所改动,原文地址:http://johnsquibb.com/tutorials
这个教程可以使大家掌握用mvc模式开发php应用的基本概念。此教程分为三个部分,现在这篇是第一部分。
现在市面上有很多流行的框架供大家使用,但是我们也可以自己动手开发一个mvc框架,采用mvc模式可以大大减少我们开发应用的时间,并且能够更好的组织项目源代码,而且其中的某些模块还可在其它项目中使用。现在我要教大家写一个简单的mvc框架。由于这个项目很简单,轻量,所以可能并不是最佳实践,也不具备安全性,还需要大家在实际应用中完善。
所用技术:php,面向对象开发方法。
开始
首先在网站根目录下建立三个文件夹
modelsviewscontrollers
然后在根目录下新建一个文件:
index.php
现在项目结构应该像这样
§ 网站根目录
§ index.php
§ models/
§ views/
§ controllers/
index.php是整个web应用的入口点,所有的用户请求都会经过它。我们会写一些代码来把用户请求分派到相应的控制器中,这些控制器存放在controllers文件夹里。之后,我们就可以用下面的方式来实现页面跳转:
http://你的域名.com/index.php?page1http://你的域名.com/index.php?page2http://你的域名.com/index.php?page3设置前端控制器index.php首先在index.php中定义网站根目录和网站域名,以便在整个应用中访问。
定义了网站根目录后,在任何php文件中,都能很方便的引用其它目录的php文件,因为index.php是入口文件,这样就能够在整个应用中访问在它之中定义的这些变量。
设置路由器router.php(转发用户请求到相应控制器)在controllers目录下新建一个文件,名字为“router.php,这个文件用来处理所有页面请求。想像一下你家里的路由器,它负责把internet路由到家中的每个电脑。router.php文件将会获取传入到index.php的页面请求,然后把请求分派给不同的控制器(controllers)。
route.php中的代码:
howtobuildaframework )
如果没有上述输出,请检查你的服务器配置是否正确,并检查代码是否有错误。现在来让我们添加一个页面到我们的网站里,这样就可以让router.php来产生一个页面,而不是直接输出上面的信息。
创建一个控制器(controller)
在controllers文件夹里新建一个文件名为“news.php,定义如下的类:
再次访问http://你的域名.com/index.php?news&article=howtobuildaframework,你将会看到从news_controller打印出来的信息。注意,我们现在用die()来处理错误,我们可以用其它更好的错误处理来规制它,但现在使用die()足够了,试试访问其它页面如http://你的域名.com/index.php?books,你会看到page does not exist!错误。创建一个model(模型)完善news_controller。假设我们有一些新闻片段来供读者阅读,那么就需要news_controller这个控制器去调用一个模型来抓取相关的新闻片段,无论它们是存储在数据库还是文件里。在models文件夹里新建一个文件,“news.php”,代码如下:
'new website' , 'content' => 'welcome to the site! we are glad to have you here.' ) , //2 'mvc' => array ( 'title' => 'php mvc frameworks are awesome!' , 'content' => 'it really is very easy. take it from us!' ) , //3 'test' => array ( 'title' => 'testing' , 'content' => 'this is just a measly test article.' ) ); public function __construct() { } /** * 根据标题获取文章 * * @param string $articlename * * @return array $article */ public function get_article($articlename) { //从数组中获取文章 $article = $this->articles[$articlename]; return $article; }}?>
现在修改controllers/news.php中的main函数:
public function main(array $getvars){ $newsmodel = new news_model; //获取一篇文章 $article = $newsmodel->get_article('test'); print_r($article);}
现在我们并没有考虑过滤用户输入的问题,因为我们现在只是为了尽快让大家掌握php mvc的基本内容,所以我们现在不必太关心这些。
如果访问如下网址:
§ http://yourdomain.com/mvc/index.php?news&article=test
你会看到如下输出:
array ( [title] => testing [content] => this is just a measly test article. )
创建视图(view)
现在我们已经有控制器和模型了,只差一个视图。视图是表现层,它是你的应用中,与用户接触最频繁的部分。之前我提到过,视图是提供与业务逻辑分离的用户接口,有很多方法可以做到这个。你可以使用模板引擎smarty或其它类似的。你也可以写一个自己的模板引擎,但那肯定是相当艰巨的任务。最后,你可以使用原生php视图。
对于目前来说,php视图足够了。这个就像以前php与html代码混合编程一样,但是有一点不同是,我们的业务逻辑已经和视图分离了。看一下如下代码:
welcome to our website! news =$data['title'];?> =$data['content'];?>
注意,嵌入的php标签利用了php 快捷操作符。这样就能够把我们的内容直接输出到html里面了。在views文件夹里新建一个文件“news.php”,把上述代码拷贝进来。现在我们有了视图文件,但是我们需要一个与视图交互的方法。在models文件夹里新建一个文件“view.php”,添加如下代码:
render = $file; } } /** * 接受从控制器赋予的变量,并保存在data数组中 * * @param $variable * @param $value */ public function assign($variable , $value) { $this->data[$variable] = $value; } public function __destruct() { //把类中的data数组变为该函数的局部变量,以方便在视图模板中使用 $data = $this->data; //渲染视图 include($this->render); }}
现在,最后一件要做的事就是从news_controller里加载视图。修改controllers/news.php:
get_article($getvars['article']); //创建一个视图,并传入该控制器的template变量 $view = new view_model($this->template); //把文章数据赋给视图模板 $view->assign('title' , $article['title']); $view->assign('content' , $article['content']); }}?>
再加载页面,你就能够看到你的视图模板中的变量,已经被正确的替换掉了。好了,你的简单的mvc框架已经搭建好了,下面我会继续讲《开发自己php mvc框架(二)》