PHP 项目结构设计：一个项目应该怎么拆

项目从几百行增长到几万行以后，目录结构会直接影响维护成本。

Controller

Controller 处理 HTTP 层：

请求
 ↓
Controller

负责读取请求、调用业务层和返回响应。

不要把所有 SQL 都塞进 Controller。

Service

Service 负责业务逻辑：

Controller
 ↓
Service

Repository

Repository 可以封装数据访问：

Service
 ↓
Repository
 ↓
Database

这样业务层不需要到处知道 SQL。

DTO

DTO 可以明确数据结构：

final class RegisterUserData
{
    public function __construct(
        public readonly string $email,
        public readonly string $password
    ) {}
}

Middleware

Middleware 适合处理：

认证
权限
日志
限流
CORS

一个实际结构

src/
├── Controller/
├── Service/
├── Repository/
├── Entity/
├── DTO/
├── Middleware/
└── Support/

config/
public/
storage/
tests/

这不是唯一答案。

最重要的是每个模块有清晰职责。

不要过度设计

小项目没必要强行套几十种设计模式。

架构应该随着复杂度增长，而不是提前制造复杂度。