PHP项目如何实现数据架构？

本文目录导读：

1. 第一阶段：基础分层（必备）
2. 第二阶段：核心模式选择
3. 第三阶段：高级数据架构技巧
4. 常见问题与解决方案
5. 最佳实践清单

PHP项目实现数据架构，核心在于分层和抽象，不要将数据库操作直接混在HTML或业务逻辑里,否则项目会迅速变得难以维护。

以下是标准化、可落地的PHP数据架构实现方案,从基础到进阶：

第一阶段：基础分层（必备）

这是任何现代PHP项目的基础,将代码分为三层：

1. 表现层 （Presentation Layer）：处理HTTP请求、表单验证、返回JSON/HTML视图,常见如MVC中的Controller。
2. 业务逻辑层 （Business Logic Layer / Service Layer）：存放核心业务规则，如“用户注册时需要验证邮箱是否唯一”、“订单创建后需要发送通知”。
3. 数据访问层 （Data Access Layer / Repository / Model）：只负责与数据库交互（CRUD）,不包含业务逻辑。

示例代码结构 （面向过程 vs OOP）:

// 错误示范：混合所有逻辑
// index.php
$conn = new mysqli('localhost', 'user', 'pass', 'db');
$result = $conn->query("SELECT * FROM users WHERE id = $_GET[id]");
echo "Hello, " . $result['name'];
// 正确架构：分层调用
// 1. 数据访问层 (UserRepository.php)
class UserRepository {
    private $db;
    public function __construct(PDO $db) { $this->db = $db; }
    public function findById(int $id): ?User {
        $stmt = $this->db->prepare("SELECT * FROM users WHERE id = :id");
        $stmt->execute([':id' => $id]);
        $data = $stmt->fetch();
        return $data ? new User(/*...*/) : null;
    }
}
// 2. 业务逻辑层 (UserService.php)
class UserService {
    public function __construct(private UserRepository $repo) {}
    public function greetUser(int $id): string {
        $user = $this->repo->findById($id);
        if (!$user) throw new \InvalidArgumentException("User not found");
        // 业务逻辑：根据用户类型调整问候语
        return "Hello, " . $user->getName();
    }
}
// 3. 控制器 (UserController.php)
class UserController {
    public function __construct(private UserService $service) {}
    public function showGreeting(Request $request): Response {
        $greeting = $this->service->greetUser($request->get('id'));
        return new JsonResponse(['message' => $greeting]);
    }
}

第二阶段：核心模式选择

使用ORM (推荐大部分项目)

ORM（如 Doctrine、Eloquent）可以解决大部分重复的CRUD工作,并通过关系映射管理表关联。

• Eloquent （Laravel自带）：适合快速开发，Active Record模式。
• Doctrine （Symfony常用）：数据映射器模式，更灵活，性能更好,适合复杂领域逻辑。

Eloquent 示例：

// User模型
class User extends Model {
    protected $fillable = ['name', 'email'];
    // 关联关系
    public function posts() {
        return $this->hasMany(Post::class);
    }
}
// 使用
$user = User::find(1);
$user->update(['name' => 'New Name']);
echo $user->posts->first()->title;

使用查询构建器 + Repository模式

如果不希望用完整ORM，可以用查询构建器（Laravel Query Builder / Symfony DBAL）加自定义Repository。

// UserRepository.php
class UserRepository {
    public function __construct(private Database $db) {}
    public function findActiveUsers(int $minAge): array {
        return $this->db->query('SELECT * FROM users WHERE active = 1 AND age > ?', [$minAge]);
    }
}

第三阶段：高级数据架构技巧

使用DTO (Data Transfer Object)

从数据库拿到的原始数据不要直接传递给视图，使用DTO可以保证数据格式稳定,防止SQL结构泄露。

class UserDTO {
    public function __construct(
        public readonly int $id,
        public readonly string $name,
        public readonly string $displayName
    ) {}
}
// 在Repository中转换
class UserRepository {
    public function findById(int $id): ?UserDTO {
        $data = $this->db->query("SELECT id, name, CONCAT(first_name, ' ', last_name) as display_name FROM users WHERE id=?", [$id]);
        if (!$data) return null;
        return new UserDTO($data['id'], $data['name'], $data['display_name']);
    }
}

处理复杂业务逻辑：领域驱动设计（DDD）

如果业务逻辑非常复杂（如电商、金融），可以考虑DDD的领域模型和值对象。

class Order {
    private array $items;
    private Money $total; // 值对象
    public function addItem(Product $product, int $quantity): void {
        // 业务规则：不能超过库存
        if ($product->stock < $quantity) throw new InsufficientStockException();
        $this->items[] = new OrderItem($product, $quantity);
        $this->recalculateTotal();
    }
}
// 数据访问通过Repository持久化
interface OrderRepositoryInterface {
    public function save(Order $order): void;
    public function findById(int $id): ?Order;
}

缓存策略

对于高并发项目,数据访问层应该支持缓存。

• Read-through缓存：先从Redis/Memcached读，没有再从数据库读,然后写入缓存。
• 缓存失效：在增删改时主动清除或更新缓存。

class CachedUserRepository implements UserRepositoryInterface {
    public function __construct(
        private UserRepositoryInterface $decorated,
        private Cache $cache
    ) {}
    public function findById(int $id): ?UserDTO {
        $key = "user_$id";
        $data = $this->cache->get($key);
        if ($data) return $data;
        $user = $this->decorated->findById($id);
        $this->cache->set($key, $user, 3600); // 缓存1小时
        return $user;
    }
}

常见问题与解决方案

最佳实践清单

1. 永远不要在Controller中直接使用SQL。
2. 必须使用预处理语句或ORM（以PDO为标准）。
3. 推荐使用 Repository模式隔离数据库实现。
4. 强烈建议 使用DTO传递数据,而非直接暴露数据库行。
5. 复杂业务 考虑Service层或领域模型。
6. 高并发 引入缓存层（Redis）。
7. 所有数据库变更 通过迁移文件管理。

按照这个架构，无论是小型博客还是大型电商系统，代码都能保持清晰、可测试和可扩展。