很多项目的问题不是”代码写错了”,而是”改不动了”。改一个字段要动五个文件,加一个功能要复制三份逻辑。根源通常在分层:职责没有边界,业务逻辑散落在控制器、模板和 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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。