手把手编写自己的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
</IfModule>
如果是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 入口文件，文件内容为：
<?php
// 应用目录为当前目录
define('APP_PATH', __DIR__ . '/');
// 开启调试模式
define('APP_DEBUG', true);
// 加载框架文件
require(APP_PATH . 'fastphp/Fastphp.php');
// 加载配置文件
$config = require(APP_PATH . 'config/config.php');
// 实例化框架类
(new Fastphp($config))->run();
注意，上面的PHP代码中，并没有添加PHP结束符号
这么做的主要原因是：
对于只有 PHP 代码的文件，最好没有结束标志
PHP自身并不需要结束符号，不加结束符让程序更加安全，很大程度防止了末尾被注入额外的内容。
3.5 配置文件
在入口文件中，我们加载了config.php文件的内容，那它有何作用呢？
从名称不难看出，它的作用是保存一些常用配置。
config.php 文件内容如下，作用是定义数据库连接参数参数，以及配置默认控制器名和操作名：
<?php
// 数据库配置
$config['db']['host'] = 'localhost';
$config['db']['username'] = 'root';
$config['db']['password'] = '123456';
$config['db']['dbname'] = 'project';
// 默认控制器和操作名
$config['defaultController'] = 'Item';
$config['defaultAction'] = 'index';
return $config;
入口中的$config变量接收到配置参数后，再传给框架的核心类，也就是Fastphp类。
3.6 框架核心类
入口文件对框架类做了两步操作：实例化，调用run()方法。
实例化操作接受
$config参数配置，并保存到类属性中。run()方法则调用用类自身方法，完成：自动加载类文件、监测开发环境、过滤敏感字符、移除全局变量的老用法、和处理路由。<?php
/**
* fastphp框架核心
*/
class Fastphp
{
protected $_config = [];
public function __construct($config)
{
$this->_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名就是：item
- action名就是：view
- URL参数就是：array(1, hello)
分割完成后，再实例化控制器：itemController，并调用其中的view方法 。
3.7 Controller基类
接下来，就是在 fastphp 中创建MVC基类，包括控制器、模型和视图三个基类。
新建控制器基类，文件名 Controller.class.php，功能就是总调度，内容如下：
<?php
/**
* 控制器基类
*/
class Controller
{
protected $_controller;
protected $_action;
protected $_view;
// 构造函数，初始化属性，并实例化对应模型
public function __construct($controller, $action)
{
$this->_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，代码如下：
<?php
class Model extends Sql
{
protected $_model;
protected $_table;
public static $dbConfig = [];
public function __construct()
{
// 连接数据库
$this->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，代码如下：
<?php
class Sql
{
protected $_dbHandle;
protected $_result;
private $filter = '';
// 连接数据库
public function connect($host, $username, $password, $dbname)
{
try {
$dsn = sprintf("mysql:host=%s;dbname=%s;charset=utf8", $host, $dbname);
$option = array(PDO::ATTR_DEFAULT_FETCH_MODE => 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 内容如下：
<?php
/**
* 视图基类
*/
class View
{
protected $variables = array();
protected $_controller;
protected $_action;
function __construct($controller, $action)
{
$this->_controller = strtolower($controller);
$this->_action = strtolower($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 模型，内容如下：
<?php
/**
* 用户Model
*/
class ItemModel extends Model
{
/**
* 自定义当前模型操作的数据库表名称，
* 如果不指定默认为类名称的小写字符串，
* 这里就是 item 表
* @var string
*/
public $_table = 'item';
/**
* 搜索功能，因为Sql父类里面没有现成的like搜索，
* 所以需要自己写SQL语句，对数据库的操作应该都放
* 在Model里面，然后提供给Controller直接调用
* @param $title string 查询的关键词
* @return array 返回的数据
*/
public function search($keyword)
{
$sql = "select * from `$this->_table` where `item_name` like '%$keyword%'";
$sth = $this->_dbHandle->prepare($sql);
$sth->execute();
return $sth->fetchAll();
}
}
因为 Item 模型继承了 Model基类，所以它拥有 Model 类的所有功能。
4.3 部署控制器
在 controllers 目录下创建一个 ItemController.php 控制器，内容如下：
<?php
class ItemController extends Controller
{
// 首页方法，测试框架自定义DB查询
public function index()
{
$keyword = isset($_GET['keyword']) ? $_GET['keyword'] : '';
if ($keyword) {
$items = (new ItemModel())->search($keyword);
} else {
$items = (new ItemModel)->selectAll();
}
$this->assign('title', '全部条目');
$this->assign('keyword', $keyword);
$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();
}
// 操作管理
public function manage($id = 0)
{
$item = array();
$postUrl = '/item/add';
if ($id) {
$item = (new ItemModel)->select($id);
$postUrl = '/item/update';
}
$this->assign('title', '管理条目');
$this->assign('item', $item);
$this->assign('postUrl', $postUrl);
$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 内容：
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title><?php echo $title ?></title>
<link rel="stylesheet" href="/static/css/main.css" type="text/css" />
</head>
<body>
<h1><?php echo $title ?></h1>
footer.php 内容：
</body>
</html>
页头文件用到了main.css样式文件，内容：
html, body {
margin: 0;
padding: 10px;
font-size: 20px;
}
input {
font-family:georgia,times;
font-size:24px;
line-height:1.2em;
}
a {
color:blue;
font-family:georgia,times;
line-height:1.2em;
text-decoration:none;
}
a:hover {
text-decoration:underline;
}
h1 {
color:#000000;
font-size:41px;
border-bottom:1px dotted #cccccc;
}
td {padding: 1px 30px 1px 0;}
然后，在 views/item 创建以下几个视图文件。
index.php，浏览数据库内 item 表的所有记录，内容：
<form action="" method="get">
<input type="text" value="<?php echo $keyword ?>" name="keyword">
<input type="submit" value="搜索">
</form>
<p><a href="/item/manage">新建</a></p>
<table>
<tr>
<th>ID</th>
<th>内容</th>
<th>操作</th>
</tr>
<?php foreach ($items as $item): ?>
<tr>
<td><?php echo $item['id'] ?></td>
<td><?php echo $item['item_name'] ?></td>
<td>
<a href="/item/manage/<?php echo $item['id'] ?>">编辑</a>
<a href="/item/delete/<?php echo $item['id'] ?>">删除</a>
</td>
</tr>
<?php endforeach ?>
</table>
add.php，添加记录后的提示，内容：
<a class="big" href="/item/index">成功添加<?php echo $count ?>条记录，点击返回</a>
manage.php，管理记录，内容：
<form action="<?php echo $postUrl; ?>" method="post">
<?php if (isset($item['id'])): ?>
<input type="hidden" name="id" value="<?php echo $item['id'] ?>">
<?php endif; ?>
<input type="text" name="value" value="<?php echo isset($item['item_name']) ? $item['item_name'] : '' ?>">
<input type="submit" value="提交">
</form>
<a class="big" href="/item/index">返回</a>
update.php，更改记录后的提示，内容：
<a class="big" href="/item/index">成功修改<?php echo $count ?>项，点击返回</a>
delete.php，删除记录后的提示，内容：
<a href="/item/index">成功删除<?php echo $count ?>项，点击返回</a>
4.5 应用测试
这样，在浏览器中访问 project程序：http://localhost/item/index/，就可以看到效果了。
以上代码已经全部发布到 github 上，关键部分加了注释：
要设计更好的MVC，或使用得更加规范，请看《MVC架构的职责划分原则》。
