首页 > 文章 > php教程

PHPMVC项目搭建与代码教程详解

时间：2025-11-27 08:42:27 385浏览收藏

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《PHPMVC项目搭建教程与代码详解》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

搭建PHPMVC项目需先设计目录结构，再配置入口文件与URL重写，接着实现Bootstrap类进行路由分发，然后创建控制器、模型和视图，最后准备数据库并运行项目。1. 项目结构包括app、public、config等目录；2. public/index.php引入Bootstrap启动应用；3. .htaccess开启URL重写将请求转发至index.php；4. Bootstrap解析URL确定控制器、方法和参数；5. 控制器调用模型获取数据并渲染视图；6. 模型通过PDO连接数据库执行查询；7. 视图为HTML模板展示数据；8. 创建数据库phpmvc及users表插入测试数据；9. 配置Web服务器指向public目录访问首页和详情页。该架构实现逻辑分离，便于维护与扩展。

如何搭建一个PHPMVC项目_PHPMVC项目搭建完整步骤与代码示例

搭建一个PHPMVC项目需要理解MVC架构的基本组成：Model（模型）、View（视图）和Controller（控制器）。通过合理组织代码结构，实现逻辑分离，提升项目的可维护性和扩展性。下面是一个完整的PHPMVC项目搭建步骤与代码示例。

1. 项目目录结构设计

合理的目录结构是MVC项目的基础。建议采用如下结构：

/project-root
│
├── /app
│   ├── /controllers
│   ├── /models
│   ├── /views
│   └── core/Bootstrap.php
│
├── /public
│   ├── index.php
│   └── /assets (css, js, images)
│
├── /config
│   └── database.php
│
└── .htaccess

说明：

/app：存放应用核心代码
/public：入口文件和静态资源，应设为Web根目录
.htaccess：用于URL重写

2. 配置入口文件和URL重写

将Web服务器的根目录指向 /public 文件夹，确保外部无法直接访问应用逻辑文件。

public/index.php

<?php
// 引入引导类启动应用
require_once '../app/core/Bootstrap.php';

$bootstrap = new Bootstrap();
$bootstrap->run();

.htaccess（放在public目录下）

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

该配置将所有非文件、非目录请求转发到index.php，由Bootstrap解析路由。

3. 实现核心引导类（Bootstrap）

app/core/Bootstrap.php

<?php
class Bootstrap {
    public function __construct() {}

    public function run() {
        // 获取URL参数
        $url = isset($_GET['url']) ? $_GET['url'] : 'home';
        $url = explode('/', rtrim($url, '/'));
        
        // 默认控制器和方法
        $controllerName = ucfirst($url[0] ?? 'Home') . 'Controller';
        $methodName = $url[1] ?? 'index';
        $params = array_slice($url, 2);

        $controllerPath = '../app/controllers/' . $controllerName . '.php';

        if (file_exists($controllerPath)) {
            require_once $controllerPath;
            if (class_exists($controllerName)) {
                $controller = new $controllerName();
                if (method_exists($controller, $methodName)) {
                    call_user_func_array([$controller, $methodName], $params);
                } else {
                    echo "方法不存在: " . $methodName;
                }
            } else {
                echo "控制器不存在: " . $controllerName;
            }
        } else {
            echo "控制器文件未找到: " . $controllerPath;
        }
    }
}

4. 创建控制器（Controller）

app/controllers/HomeController.php

<?php
require_once '../models/UserModel.php';

class HomeController {
    private $model;

    public function __construct() {
        $this->model = new UserModel();
    }

    public function index() {
        $users = $this->model->getAllUsers();
        require_once '../views/home/index.php';
    }

    public function view($id) {
        $user = $this->model->getUserById($id);
        require_once '../views/home/view.php';
    }
}

5. 创建模型（Model）

app/models/UserModel.php

<?php
require_once '../../config/database.php';

class UserModel {
    private $db;

    public function __construct() {
        $this->db = new PDO(DB_DSN, DB_USER, DB_PASS);
    }

    public function getAllUsers() {
        $stmt = $this->db->query("SELECT id, name, email FROM users");
        return $stmt->fetchAll(PDO::FETCH_ASSOC);
    }

    public function getUserById($id) {
        $stmt = $this->db->prepare("SELECT id, name, email FROM users WHERE id = ?");
        $stmt->execute([$id]);
        return $stmt->fetch(PDO::FETCH_ASSOC);
    }
}

config/database.php

<?php
define('DB_DSN', 'mysql:host=localhost;dbname=phpmvc;charset=utf8');
define('DB_USER', 'root');
define('DB_PASS', '');

6. 创建视图（View）

app/views/home/index.php

<!DOCTYPE html>
<html>
<head>
  <title>用户列表</title>
</head>
<body>
  <h1>用户列表</h1>
  <ul>
  <?php foreach ($users as $user): ?>
    <li><a href="/view/<?= $user['id'] ?>"><?= htmlspecialchars($user['name']) ?></a></li>
  <?php endforeach; ?>
  </ul>
</body>
</html>

app/views/home/view.php

<!DOCTYPE html>
<html>
<head>
  <title>查看用户</title>
</head>
<body>
  <h1>用户详情</h1>
  <p>姓名：<?= htmlspecialchars($user['name']) ?></p>
  <p>邮箱：<?= htmlspecialchars($user['email']) ?></p>
  <a href="/">返回首页</a>
</body>
</html>

7. 数据库准备

创建测试数据库和表：

CREATE DATABASE phpmvc;
USE phpmvc;

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  email VARCHAR(100) NOT NULL
);

INSERT INTO users (name, email) VALUES ('张三', 'zhangsan@example.com');
INSERT INTO users (name, email) VALUES ('李四', 'lisi@example.com');

8. 运行项目

启动本地服务器（如Apache或Nginx），将DocumentRoot指向 /project-root/public，访问：

http://localhost/ → 显示用户列表
http://localhost/view/1 → 查看ID为1的用户

基本上就这些。这套结构清晰、易于扩展，适合学习和小型项目使用。关键在于理解路由分发、类自动加载（可后续引入spl_autoload_register）和三层分离原则。不复杂但容易忽略细节，比如路径引用和安全过滤。逐步完善后可加入更多功能如中间件、模板引擎等。

到这里，我们也就讲完了《PHPMVC项目搭建与代码教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！