按功能拆分目录并使用命名空间实现模块化，将配置、控制器、业务逻辑分离，提升PHP项目可维护性与扩展性，关键在于高内聚、低耦合，每个文件职责单一。
PHP源码的模块化拆分与功能分离是提升项目可维护性、扩展性和团队协作效率的关键步骤。直接在一个文件中写大量逻辑会带来后期难以维护的问题。通过合理拆分，可以让代码结构更清晰，职责更明确。
按功能划分目录结构
良好的目录结构是模块化第一步。根据业务或功能将代码分类存放，便于查找和管理。
常见基础结构如下：
- /app - 核心业务逻辑，如模型、服务类
- /config - 配置文件，数据库、路由等
- /controllers - 处理HTTP请求的控制器
- /models - 数据操作层，对应数据库表
- /views - 模板文件，展示层
- /lib 或 /utils - 公共工具函数或类
- /routes - 路由定义
例如用户管理模块可以放在 /app/User/ 下，包含 UserController.php、UserService.php、UserModel.php 等。
立即学习“PHP免费学习笔记（深入）”；
使用命名空间组织类文件
PHP的命名空间能有效避免类名冲突，并支持自动加载（如 Composer 的 PSR-4 规范）。
示例：定义一个用户服务类
# 文件路径：app/User/UserService.php
<?php
<p>namespace App\User;</p><p>class UserService {
public function getAllUsers() {
// 业务逻辑
}
}</p>在其他地方调用时：
use App\User\UserService; $service = new UserService();
配合 Composer 配置自动加载后，无需手动 include，系统会自动找到类文件。
分离配置与逻辑代码
不要把数据库连接信息、API密钥等硬编码在逻辑中。应提取到独立配置文件。
- 创建 config/database.php 返回数据库参数数组
- 在初始化脚本中引入配置并传入PDO或其他ORM
- 不同环境（开发/生产）可用不同配置文件切换
这样修改配置不影响主逻辑，也方便部署。
控制器与业务逻辑解耦
很多初学者习惯在控制器里写SQL和校验逻辑，导致臃肿。正确做法是：
- 控制器只负责接收请求、调用服务、返回响应
- 具体逻辑交给 Service 层处理
- 数据存取由 Model 或 Repository 完成
比如注册用户操作：
// Controller 中
public function register($request) {
$validator = new UserValidator();
if (!$validator->isValid($request)) {
return ['error' => '数据不合法'];
}
<pre class='brush:php;toolbar:false;'>$service = new UserService();
return $service->createUser($request);}
真正创建用户的逻辑在 UserService 内部实现，控制器无需关心细节。
基本上就这些。模块化不是一蹴而就的过程，但从小项目开始养成拆分意识，对后续发展非常有帮助。关键是做到高内聚、低耦合，每个文件只做一件事。
