PHP入门教程之手把手编写自己的PHP MVC框架

1 什么是MVC

MVC模式（Model-View-Controller）是软件工程中的一种软件架构模式。

MVC把软件系统分为三个基本部分：模型（Model）、视图（View）和控制器（Controller）。

PHP中MVC模式也称Web MVC，从上世纪70年代进化而来。

MVC的目的是实现一种动态的程序设计，便于后续对程序的修改和扩展简化，并且使程序某一部分的重复利用成为可能。

除此之外，此模式通过对复杂度的简化，使程序结构更加直观。

MVC各部分的职能：

模型Model – 管理大部分的业务逻辑和所有的数据库逻辑。模型提供了连接和操作数据库的抽象层。控制器Controller - 负责响应用户请求、准备数据，以及决定如何展示数据。视图View – 负责渲染数据，通过HTML方式呈现给用户。

一个典型的Web MVC流程：

Controller截获用户发出的请求；Controller调用Model完成状态的读写操作；Controller把数据传递给View；View渲染最终结果并呈献给用户。

2 为什么要自己开发MVC框架

网络上有大量优秀的MVC框架可供使用，本教程并不是为了开发一个全面的、终极的MVC框架解决方案。

我们将它看作是一个很好的从内部学习PHP的机会。

在此过程中，你将学习面向对象编程和MVC设计模式，并学习到开发中的一些注意事项。

更重要的是，通过自制MVC框架，每个人都可以完全控制自己的框架，将你的想法融入到你开发的框架中。

虽然不一定是最好的，但是你可以按照自己的方式开发各种功能。

3 开始开发自己的MVC框架

3.1 目录准备

在开始开发前，让我们先来把项目建立好。

假设我们建立的项目为 project，MVC的框架命名为 fastphp，那么接下来，第一步要把目录结构设置好。

project WEB部署目录 ├─application 应用目录 │ ├─controllers 控制器目录 │ ├─models 模块目录 │ ├─views 视图目录 ├─config 配置文件目录 ├─fastphp 框架核心目录 ├─static 静态文件目录 ├─index.php 入口文件

然后把Nginx或者Apache的站点根目录配置到project目录。

3.2 代码规范

在目录设置好以后，我们接下来规定代码的规范：

MySQL的表名需小写或小写加下划线，如：item，car_orders。模块名（Models）需用大驼峰命名法，即首字母大写，并在名称后添加Model，如：ItemModel，CarModel。控制器（Controllers）需用大驼峰命名法，即首字母大写，并在名称后添加Controller，如：ItemController，CarController。方法名（Action）需用小驼峰命名法，即首字母小写，如：index，indexPost。视图（Views）部署结构为控制器名/行为名，如：item/view.php，car/buy.php。

上述规则是为了程序能更好地相互调用。

接下来就开始真正的PHP MVC编程了。

3.3 重定向

重定向的目的有两个：设置根目录为project所在位置，以及将所有请求都发送给 index.php 文件。

如果是Apache服务器，在 project 目录下新建一个 .htaccess 文件，内容为：

<IfModule mod_rewrite.c> # 打开Rerite功能 RewriteEngine On # 如果请求的是真实存在的文件或目录，直接访问 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d # 如果访问的文件或目录不是真事存在，分发请求至 index.php RewriteRule . index.php

如果是Nginx服务器，修改配置文件，在server块中加入如下的重定向：

location / { # 重新向所有非真是存在的请求到index.php try_files $uri $uri/ /index.php$args; }

这样做的主要原因是：

（1）静态文件能直接访问。

如果文件或者目录真实存在，则直接访问存在的文件/目录。

比如，静态文件static/css/main.css真实存在，就可以直接访问它。

（2）程序有单一的入口。

这种情况是请求地址不是真实存在的文件或目录，这样请求就会传到 index.php 上。

例如，访问地址：localhost/item/view/1，在文件系统中并不存在这样的文件或目录。

那么，Apache或Nginx服务器会把请求发给index.php，并且把域名之后的字符串赋值给REQUEST_URI变量。

这样在PHP中用$_SERVER['REQUEST_URI']就能拿到/item/view/1；

（3）可以用来生成美化的URL，利于SEO。

3.4 入口文件

接下来，在 project 目录下新建 index.php 入口文件，文件内容为：

run(); 注意，上面的PHP代码中，并没有添加PHP结束符号?>

。

这么做的主要原因是：

对于只有 PHP 代码的文件，最好没有结束标志?>，

PHP自身并不需要结束符号，不加结束符让程序更加安全，很大程度防止了末尾被注入额外的内容。

3.5 配置文件

在入口文件中，我们加载了config.php文件的内容，那它有何作用呢？

从名称不难看出，它的作用是保存一些常用配置。

config.php 文件内容如下，作用是定义数据库连接参数参数，以及配置默认控制器名和操作名：

\_config = $config; } // 运行程序 public function run() { spl\_autoload\_register(array($this, 'loadClass')); $this->setReporting(); $this->removeMagicQuotes(); $this->unregisterGlobals(); $this->setDbConfig(); $this->route(); } // 路由处理 public function route() { $controllerName = $this->\_config\['defaultController'\]; $actionName = $this->\_config\['defaultAction'\]; $param = array(); $url = $\_SERVER\['REQUEST\_URI'\]; // 清除?之后的内容 $position = strpos($url, '?'); $url = $position === false ? $url : substr($url, 0, $position); // 删除前后的“/” $url = trim($url, '/'); if ($url) { // 使用“/”分割字符串，并保存在数组中 $urlArray = explode('/', $url); // 删除空的数组元素 $urlArray = array\_filter($urlArray); // 获取控制器名 $controllerName = ucfirst($urlArray\[0\]); // 获取动作名 array\_shift($urlArray); $actionName = $urlArray ? $urlArray\[0\] : $actionName; // 获取URL参数 array\_shift($urlArray); $param = $urlArray ? $urlArray : array(); } // 判断控制器和操作是否存在 $controller = $controllerName . 'Controller'; if (!class\_exists($controller)) { exit($controller . '控制器不存在'); } if (!method\_exists($controller, $actionName)) { exit($actionName . '方法不存在'); } // 如果控制器和操作名存在，则实例化控制器，因为控制器对象里面 // 还会用到控制器名和操作名，所以实例化的时候把他们俩的名称也 // 传进去。结合Controller基类一起看 $dispatch = new $controller($controllerName, $actionName); // $dispatch保存控制器实例化后的对象，我们就可以调用它的方法， // 也可以像方法中传入参数，以下等同于：$dispatch->$actionName($param) call\_user\_func\_array(array($dispatch, $actionName), $param); } // 检测开发环境 public function setReporting() { if (APP\_DEBUG === true) { error\_reporting(E\_ALL); ini\_set('display\_errors','On'); } else { error\_reporting(E\_ALL); ini\_set('display\_errors','Off'); ini\_set('log\_errors', 'On'); } } // 删除敏感字符 public function stripSlashesDeep($value) { $value = is\_array($value) ? array\_map(array($this, 'stripSlashesDeep'), $value) : stripslashes($value); return $value; } // 检测敏感字符并删除 public function removeMagicQuotes() { if (get\_magic\_quotes\_gpc()) { $\_GET = isset($\_GET) ? $this->stripSlashesDeep($\_GET ) : ''; $\_POST = isset($\_POST) ? $this->stripSlashesDeep($\_POST ) : ''; $\_COOKIE = isset($\_COOKIE) ? $this->stripSlashesDeep($\_COOKIE) : ''; $\_SESSION = isset($\_SESSION) ? $this->stripSlashesDeep($\_SESSION) : ''; } } // 检测自定义全局变量并移除。因为 register\_globals 已经弃用，如果 // 已经弃用的 register\_globals 指令被设置为 on，那么局部变量也将 // 在脚本的全局作用域中可用。例如， $\_POST\['foo'\] 也将以 $foo 的 // 形式存在，这样写是不好的实现，会影响代码中的其他变量。相关信息， // 参考: http://php.net/manual/zh/faq.using.php#faq.register-globals public function unregisterGlobals() { if (ini\_get('register\_globals')) { $array = array('\_SESSION', '\_POST', '\_GET', '\_COOKIE', '\_REQUEST', '\_SERVER', '\_ENV', '\_FILES'); foreach ($array as $value) { foreach ($GLOBALS\[$value\] as $key => $var) { if ($var === $GLOBALS\[$key\]) { unset($GLOBALS\[$key\]); } } } } } // 配置数据库信息 public function setDbConfig() { if ($this->\_config\['db'\]) { Model::$dbConfig = $this->\_config\['db'\]; } } // 自动加载控制器和模型类 public static function loadClass($class) { $frameworks = \_\_DIR\_\_ . '/' . $class . '.php'; $controllers = APP\_PATH . 'application/controllers/' . $class . '.php'; $models = APP\_PATH . 'application/models/' . $class . '.php'; if (file\_exists($frameworks)) { // 加载框架核心类 include $frameworks; } elseif (file\_exists($controllers)) { // 加载应用控制器类 include $controllers; } elseif (file\_exists($models)) { //加载应用模型类 include $models; } else { // 错误代码 } } } 下面重点讲解主请求方法 route()，它也称路由方法，作用是：截取URL，并解析出控制器名、方法名和URL参数。假设我们的 URL 是这样： yoursite.com/controllerName/actionName/queryString 当浏览器访问上面的URL，route()从全局变量 $\_SERVER\['REQUEST\_URI'\]中获取到字符串/controllerName/actionName/queryString。然后，会将这个字符串分割成三部分：controller、action 和 queryString。例如，URL链接为：yoursite.com/item/view/1/hello，那么route()分割之后， Controller名就是：itemaction名就是：viewURL参数就是：array(1, hello) 分割完成后，再实例化控制器：itemController，并调用其中的view方法。 3.7 Controller基类接下来，就是在 fastphp 中创建MVC基类，包括控制器、模型和视图三个基类。新建控制器基类，文件名 Controller.class.php，功能就是总调度，内容如下： \_controller = $controller; $this->\_action = $action; $this->\_view = new View($controller, $action); } // 分配变量 public function assign($name, $value) { $this->\_view->assign($name, $value); } // 渲染视图 public function render() { $this->\_view->render(); } } Controller 类用assign()方法实现把变量保存到View对象中。这样，在调用$this-> render() 后视图文件就能显示这些变量。 3.8 Model基类新建模型基类，继承自数据库操作类Sql类（因为数据库操作比较复杂）。模型基类文件名为 Model.class.php，代码如下： connect(self::$dbConfig\['host'\], self::$dbConfig\['username'\], self::$dbConfig\['password'\], self::$dbConfig\['dbname'\]); // 获取数据库表名 if (!$this->\_table) { // 获取模型类名称 $this->\_model = get\_class($this); // 删除类名最后的 Model 字符 $this->\_model = substr($this->\_model, 0, -5); // 数据库表名与类名一致 $this->\_table = strtolower($this->\_model); } } } 建立一个数据库基类 Sql.class.php，代码如下： PDO::FETCH\_ASSOC); $this->\_dbHandle = new PDO($dsn, $username, $password, $option); } catch (PDOException $e) { exit('错误: ' . $e->getMessage()); } } // 查询条件 public function where($where = array()) { if (isset($where)) { $this->filter .= ' WHERE '; $this->filter .= implode(' ', $where); } return $this; } // 排序条件 public function order($order = array()) { if(isset($order)) { $this->filter .= ' ORDER BY '; $this->filter .= implode(',', $order); } return $this; } // 查询所有 public function selectAll() { $sql = sprintf("select \* from \`%s\` %s", $this->\_table, $this->filter); $sth = $this->\_dbHandle->prepare($sql); $sth->execute(); return $sth->fetchAll(); } // 根据条件 (id) 查询 public function select($id) { $sql = sprintf("select \* from \`%s\` where \`id\` = '%s'", $this->\_table, $id); $sth = $this->\_dbHandle->prepare($sql); $sth->execute(); return $sth->fetch(); } // 根据条件 (id) 删除 public function delete($id) { $sql = sprintf("delete from \`%s\` where \`id\` = '%s'", $this->\_table, $id); $sth = $this->\_dbHandle->prepare($sql); $sth->execute(); return $sth->rowCount(); } // 自定义SQL查询，返回影响的行数 public function query($sql) { $sth = $this->\_dbHandle->prepare($sql); $sth->execute(); return $sth->rowCount(); } // 新增数据 public function add($data) { $sql = sprintf("insert into \`%s\` %s", $this->\_table, $this->formatInsert($data)); return $this->query($sql); } // 修改数据 public function update($id, $data) { $sql = sprintf("update \`%s\` set %s where \`id\` = '%s'", $this->\_table, $this->formatUpdate($data), $id); return $this->query($sql); } // 将数组转换成插入格式的sql语句 private function formatInsert($data) { $fields = array(); $values = array(); foreach ($data as $key => $value) { $fields\[\] = sprintf("\`%s\`", $key); $values\[\] = sprintf("'%s'", $value); } $field = implode(',', $fields); $value = implode(',', $values); return sprintf("(%s) values (%s)", $field, $value); } // 将数组转换成更新格式的sql语句 private function formatUpdate($data) { $fields = array(); foreach ($data as $key => $value) { $fields\[\] = sprintf("\`%s\` = '%s'", $key, $value); } return implode(',', $fields); } } 应该说，Sql.class.php 是框架的核心部分。为什么？因为通过它，我们创建了一个 SQL 抽象层，可以大大减少了数据库的编程工作。虽然 PDO 接口本来已经很简洁，但是抽象之后框架的可灵活性更高。这里的数据库句柄$this->\_dbHandle还能用单例模式返回，让数据读写更高效，这部分可自行实现。 3.9 View基类视图基类 View.class.php 内容如下： \_controller = $controller; $this->\_action = $action; } // 分配变量 public function assign($name, $value) { $this->variables\[$name\] = $value; } // 渲染显示 public function render() { extract($this->variables); $defaultHeader = APP\_PATH . 'application/views/header.php'; $defaultFooter = APP\_PATH . 'application/views/footer.php'; $controllerHeader = APP\_PATH . 'application/views/' . $this->\_controller . '/header.php'; $controllerFooter = APP\_PATH . 'application/views/' . $this->\_controller . '/footer.php'; $controllerLayout = APP\_PATH . 'application/views/' . $this->\_controller . '/' . $this->\_action . '.php'; // 页头文件 if (file\_exists($controllerHeader)) { include ($controllerHeader); } else { include ($defaultHeader); } include ($controllerLayout); // 页脚文件 if (file\_exists($controllerFooter)) { include ($controllerFooter); } else { include ($defaultFooter); } } } 这样，核心的PHP MVC框架核心就完成了。下面我们编写应用来测试框架功能。 4 应用 4.1 数据库部署在 SQL 中新建一个 project 数据库，增加一个item 表、并插入两条记录，命令如下： CREATE DATABASE \`project\` DEFAULT CHARACTER SET utf8 COLLATE utf8\_general\_ci;USE \`project\`;CREATE TABLE \`item\` ( \`id\` int(11) NOT NULL auto\_increment, \`item\_name\` varchar(255) NOT NULL, PRIMARY KEY (\`id\`) ) ENGINE=InnoDB AUTO\_INCREMENT=1 DEFAULT CHARSET=utf8; INSERT INTO \`item\` VALUES(1, 'Hello World.');INSERT INTO \`item\` VALUES(2, 'Lets go!'); 4.2 部署模型然后，我们还需要在 models 目录中创建一个 ItemModel.php 模型，内容如下： selectAll(); $this->assign('title', '全部条目'); $this->assign('items', $items); $this->render(); } // 添加记录，测试框架DB记录创建（Create） public function add() { $data\['item\_name'\] = $\_POST\['value'\]; $count = (new ItemModel)->add($data); $this->assign('title', '添加成功'); $this->assign('count', $count); $this->render(); } // 查看记录，测试框架DB记录读取（Read） public function view($id = null) { $item = (new ItemModel)->select($id); $this->assign('title', '正在查看' . $item\['item\_name'\]); $this->assign('item', $item); $this->render(); } // 更新记录，测试框架DB记录更新（Update） public function update() { $data = array('id' => $\_POST\['id'\], 'item\_name' => $\_POST\['value'\]); $count = (new ItemModel)->update($data\['id'\], $data); $this->assign('title', '修改成功'); $this->assign('count', $count); $this->render(); } // 删除记录，测试框架DB记录删除（Delete） public function delete($id = null) { $count = (new ItemModel)->delete($id); $this->assign('title', '删除成功'); $this->assign('count', $count); $this->render(); } } 4.4 部署视图在 views 目录下新建 header.php 和 footer.php 两个页头页脚模板，如下。 header.php 内容： <?php echo $title ?>

footer.php 内容：

页头文件用到了main.css样式文件，内容：

input { font-family:georgia,times; font-size:24px; line-height:1.2em; }a { color:blue; font-family:georgia,times; font-size:20px; line-height:1.2em; text-decoration:none; }a:hover { text-decoration:underline; }h1 { color:#000000; font-size:41px; border-bottom:1px dotted #cccccc; }

然后，在 views/item 创建以下几个视图文件。

index.php，浏览数据库内 item 表的所有记录，内容：

---- 删除

add.php，添加记录，内容：

成功添加条记录，点击返回

view.php，查看单条记录，内容：

update.php，更改记录，内容：

成功修改项，点击返回

delete.php，删除记录，内容：

成功删除项，点击返回

4.5 应用测试

这样，在浏览器中访问 project程序：http://localhost/item/index/，就可以看到效果了。