很多项目的问题不是”代码写错了”,而是”改不动了”。改一个字段要动五个文件,加一个功能要复制三份逻辑。根源通常在分层:职责没有边界,业务逻辑散落在控制器、模板和 SQL 里。
一个够用的分层
src/
├── Controller/ 接收请求、参数校验、返回响应
├── Service/ 业务编排、事务边界
├── Repository/ 数据访问,封装 SQL 与缓存
├── Model/ 数据结构与领域行为
├── Support/ 工具类、助手函数
└── Middleware/ 鉴权、日志、限流
每层该做什么、不该做什么
| 层 | 该做 | 不该做 |
|---|---|---|
| Controller | 取参数、调用 Service、返回 JSON/视图 | 写 SQL、写业务判断 |
| Service | 编排流程、控制事务、抛业务异常 | 直接拼 HTML、依赖 $_POST |
| Repository | 查询、写入、缓存读写 | 做业务判断、发邮件 |
| Model | 字段定义、简单领域方法 | 跨表复杂查询 |
一个具体例子
<?php
// Controller:只做协议转换
final class OrderController
{
public function __construct(private OrderService $service) {}
public function store(Request $req): Response
{
$input = CreateOrderInput::fromArray($req->all());
$order = $this->service->create($input);
return Response::json(['id' => $order->id], 201);
}
}
// Service:业务与事务边界
final class OrderService
{
public function __construct(
private OrderRepository $orders,
private StockRepository $stock,
) {}
public function create(CreateOrderInput $input): Order
{
return $this->orders->transaction(function () use ($input) {
$this->stock->deduct($input->sku, $input->qty);
return $this->orders->insert($input);
});
}
}
不要过度分层
见过把项目拆成二十个目录、每层只有一个类的写法,那不是架构,是负担。判断标准:这一层是否真的隔离了变化。如果 Repository 只是把 $pdo->query() 原样包一层,那它没有价值;但如果它同时处理了缓存、读写分离、软删除过滤,就很有价值。
目录结构的两个原则
- 按职责分,不按文件类型分:把所有 Model 塞一个目录,业务一复杂就找不到东西;
- 公开入口只有 public/:其余目录都不该被 Web 直接访问,避免源码泄露。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。