如何搭建一个PHPMVC项目_PHPMVC项目搭建完整步骤与代码示例-php教程-PHP中文网

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

雪夜

发布： 2025-11-22 14:36:07

原创

156人浏览过

搭建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 文件夹，确保外部无法直接访问应用逻辑文件。

立即学习“PHP免费学习笔记（深入）”；

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

LobeHub

LobeChat brings you the best user experience of ChatGPT, OLLaMA, Gemini, Claude

201

查看详情

<?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');

登录后复制