PHP 本身无强制分层,MVC 是人为组织方式;index.php 写数据库查询违背职责分离原则,导致维护困难;Model 应是业务实体而非数据表映射;路由是分层起点,否则目录划分只是假分层。

PHP 本身没有强制分层架构,所谓“MVC”“三层架构”是开发者自己组织代码的方式,不是语言内置规则。搞不清分层,往往是因为把框架约定当成了 PHP 本身特性,或混淆了“物理目录结构”和“职责划分逻辑”。
为什么 index.php 里写数据库查询就是错的?
这不是语法错误,而是职责混杂:入口文件(index.php)本该只做请求分发和响应输出,一旦在里面调用 mysqli_query() 或 PDO::prepare(),就等于把数据访问逻辑、业务逻辑、表现逻辑全塞进一个函数作用域。后续改 SQL、换模板、加日志都会互相牵扯。
- 改个字段名要翻遍所有
index.php和controller文件 - 想把 MySQL 换成 PostgreSQL,得逐个找
new PDO(...)实例并重写 DSN 和语法 - 单元测试时无法单独验证业务规则,因为数据库连接和 HTML 输出总是一起出现
model 不是数据库表映射,而是业务实体抽象
新手常以为 UserModel 就是 SELECT * FROM users 的封装,其实它该表达“用户能做什么”——比如 canApplyForLeave()、hasActiveSubscription()。数据库操作只是实现细节,应下沉到 UserRepository 或 DataMapper 这类更底层的类中。
-
UserModel可以不依赖任何数据库类,只含属性和业务方法 - 真正执行 SQL 的是
UserRepository::findByEmail(),它返回一个UserModel实例 - 测试
UserModel时,直接 new 它、调它的方法,完全不用启动 MySQL
路由没配好,再标准的分层也是假分层
很多新手把文件按 controllers/、models/、views/ 分好目录,但所有请求都打到同一个 index.php,且里面用 $_GET['action'] 直接 include 控制器——这等于用文件夹假装分层,实际仍是过程式脚本。
立即学习“PHP免费学习笔记(深入)”;
- 真正的分层起点是路由:用
$_SERVER['REQUEST_URI']或现代路由器(如nikic/fast-route)解析出POST /api/orders应该调用哪个类的哪个方法 - 控制器(
OrderController)只负责拿参数、调OrderService、返回 JSON 或跳转,不能碰echo或file_get_contents() - 如果控制器里还看到
require 'config/database.php',说明分层还没开始
// 示例:真正的轻量分层入口(非框架)
$router = new Router();
$router->post('/api/orders', [OrderController::class, 'create']);
$router->run(); // 此处才真正触发 Controller → Service → Repository 流程
分层最难的不是写多少层,而是每次加一行代码前,先问一句:这行该出现在哪一层?如果答案模糊,八成是边界被打破了。











