不是所有项目都需要上大型框架。本文分享一套适合小型项目的 PHP 接口架构思路,兼顾开发效率与代码规范,用最少的依赖实现 MVC 分层、自动加载与统一响应。
很多个人开发者做小项目时容易陷入两个极端:要么全部写在一个文件里,后期难以维护;要么引入重型框架,增加了不必要的复杂度。其实一套精简的架构就能满足大多数接口需求。
基础目录结构建议分为四个核心目录: app 存放业务代码, public 作为入口目录, config 存放配置文件, vendor 管理第三方依赖。入口文件只做一件事:加载框架引导文件,解析路由,分发请求。路由层可以用简单的正则匹配,也可以引入轻量路由库,实现 RESTful 风格的接口定义。
MVC 分层不需要过度设计。Model 层封装数据库操作,避免 SQL 语句散落在各处;Controller 层接收参数、校验、调用业务逻辑、返回响应;业务逻辑复杂时可以抽出 Service 层,让控制器保持轻薄。数据库操作推荐用 PDO 封装一个简单的查询构造器,既安全又能提升开发效率。
统一响应格式是提升协作效率的关键。所有接口返回固定结构:状态码、提示信息、业务数据。异常情况统一捕获,按错误码返回对应提示,前端处理起来会非常顺畅。再加上简单的日志记录和参数校验,一个轻量且规范的接口架构就成型了。