如何搭建一个PHPMVC项目_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项目需要理解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

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




4. 创建控制器(Controller)

app/controllers/HomeController.php

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

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




6. 创建视图(View)

app/views/home/index.php




  用户列表


  

用户列表

  • ">

app/views/home/view.php




  查看用户


  

用户详情

姓名:

邮箱:

返回首页

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)和三层分离原则。不复杂但容易忽略细节,比如路径引用和安全过滤。逐步完善后可加入更多功能如中间件、模板引擎等。