PHP手写简易MVC框架：核心原理与代码实现

听雨眠

发布时间：2026-10-13 | 2人浏览过

原创

在PHP开发中，MVC（Model-View-Controller）模式通过将业务逻辑、数据层和表现层分离，显著提升了项目的可维护性与扩展性。本文将深入解析PHP环境下MVC的工作原理，并提供一套轻量级的简易MVC框架实现代码，涵盖目录结构、核心分发函数及各组件的具体调用流程。

核心目标与准备条件

MVC架构的核心目的是解决Web开发中代码耦合度过高的问题，实现开发（逻辑）与设计（界面）的相对独立。其基本流程遵循：

用户请求：访问入口文件，触发控制器调度。
控制器处理：根据路由参数，决定调用哪个模型获取数据，并指定使用哪个视图进行渲染。
模型交互：负责业务逻辑处理及数据库数据读写，将结构化数据返回给控制器。
视图输出：接收控制器传递的数据，结合模板生成最终的HTML页面输出给用户。

项目目录结构

构建一个标准的简易MVC项目，建议采用以下清晰的目录结构，便于后续维护与模块复用：

主要目录说明：

libs/：存放核心类库，如基础控制器、模型、视图抽象类及公共函数。
controllers/：存放具体的控制器类文件。
models/：存放数据模型类文件。
views/：存放视图模板文件或视图类文件。
index.php：项目入口文件（本例中简化为直接在测试文件中演示）。

代码实现步骤

第1步：配置核心辅助函数

为了简化控制器、模型和视图的实例化过程，通常在 function.php 或公共配置文件中定义快捷调用函数。这些函数利用 eval 或命名空间（现代PHP推荐）动态创建对象，减少冗余代码。

<?php
// function.php - 核心辅助函数

/**
 * 控制器调用函数
 * @param string $name 控制器名称 (不含Controller后缀)
 * @param string $method 调用的方法名
 */
function C($name, $method){
    require_once('libs/Controller/'.$name.'Controller.class.php');
    // 注意：eval在复杂项目中需谨慎使用，现代框架多采用反射或自动加载
    eval('$obj = new '.$name.'Controller(); $obj->'.$method.'();');
}

/**
 * 模型调用函数
 * @param string $name 模型名称 (不含Model后缀)
 * @return object 模型实例
 */
function M($name){
    require_once('libs/Model/'.$name.'Model.class.php');
    eval('$obj = new '.$name.'Model();');
    return $obj;
}

/**
 * 视图调用函数
 * @param string $name 视图名称 (不含View后缀)
 * @return object 视图实例
 */
function V($name){
    require_once('libs/View/'.$name.'View.class.php');
    eval('$obj = new '.$name.'View();');
    return $obj;
}

/**
 * 简单的输入过滤函数
 * @param string $str 待处理字符串
 * @return string 处理后字符串
 */
function daddslashes($str){
    return (!get_magic_quotes_gpc()) ? addslashes($str) : $str;
}
?>

第2步：实现控制器 (Controller)

控制器是MVC的心脏，负责协调Model和View。它不直接处理数据，而是作为中转站。下面以 testController.class.php 为例：

<?php
// testController.class.php
/*
 * 控制器作用：
 * 1. 接收请求参数
 * 2. 调用对应的Model获取数据
 * 3. 调用对应的View渲染数据
 */
class testController {
    public function show() {
        // 1. 调用模型获取数据
        // 使用简写函数 M('test') 会自动引入 libs/Model/testModel.class.php
        $testModel = M('test');
        $data = $testModel->get();
        
        // 2. 调用视图展示数据
        // 使用简写函数 V('test') 会自动引入 libs/View/testView.class.php
        $testView = V('test');
        $testView->display($data);
    }
}
?>

第3步：实现模型 (Model)

Model层专注于数据逻辑。在实际项目中，这里通常会连接数据库进行CRUD操作。在本示例中，我们模拟一个简单的数据获取：

<?php
// testModel.class.php
/*
 * 模型作用：
 * 负责数据的获取、处理和返回。
 * 不包含任何HTML或UI相关的代码。
 */
class testModel {
    public function get() {
        // 模拟从数据库或API获取数据
        // 实际场景中：$pdo->query("SELECT * FROM ...")
        return "Hello World from Model";
    }
}
?>

第4步：实现视图 (View)

View层负责数据的呈现。它只接收Controller传来的数据进行渲染，不处理业务逻辑：

<?php
// testView.class.php
/*
 * 视图作用：
 * 将Model提供的数据进行组织、美化，并最终向用户终端输出HTML。
 */
class testView {
    public function display($data) {
        echo '<!DOCTYPE html><html><body>';
        echo '<h1>MVC Demo</h1>';
        echo '<p>' . htmlspecialchars($data) . '</p>'; // 注意转义以防XSS
        echo '</body></html>';
    }
}
?>

第5步：执行流程演示

在入口文件或直接调用时，只需实例化控制器并执行对应方法。以下是完整的调用链路图示：

具体执行代码如下：

<?php
// test.php - 入口演示
require_once('libs/function.php'); // 引入辅助函数

// 模拟用户访问 /test/show
// 通常大型框架会通过 Router 类解析 URL 后调用 C('Test', 'show')
C('test', 'show');
?>