Какие плюсы и минусы между Active Record от Doctrine?

Сравнение подходов Active Record и Data Mapper в Doctrine

Active Record и Data Mapper — это два принципиально разных подхода к объектно-реляционному отображению (ORM), реализованные в библиотеке Doctrine. В Doctrine 1.x использовался Active Record, а начиная с Doctrine 2.x произошёл переход к паттерну Data Mapper. Вот их ключевые различия.

Основные концепции

Active Record — паттерн, где объект бизнес-логики содержит как данные, так и поведение для работы с базой данных. Сущность "знает" о способах своего сохранения и загрузки.

// Пример Active Record (Doctrine 1.x стиль)
class User extends Doctrine_Record
{
    public function setTableDefinition() {
        $this->hasColumn('username', 'string', 255);
        $this->hasColumn('email', 'string', 255);
    }
    
    public function save() {
        parent::save(); // Объект сам себя сохраняет
    }
}

$user = new User();
$user->username = 'john';
$user->save(); // Прямой вызов save() у объекта

Data Mapper — паттерн, где объекты предметной области не знают о механизмах сохранения. Отдельный слой (Mapper) отвечает за перенос данных между объектами и БД.

// Пример Data Mapper (Doctrine 2.x стиль)
/**
 * @Entity
 * @Table(name="users")
 */
class User
{
    /**
     * @Id
     * @GeneratedValue
     * @Column(type="integer")
     */
    private $id;
    
    /**
     * @Column(type="string")
     */
    private $username;
    
    // Геттеры и сеттеры
}

// Объект не знает о сохранении
$user = new User();
$user->setUsername('john');

// EntityManager (маппер) управляет сохранением
$entityManager->persist($user);
$entityManager->flush();

Преимущества Active Record

Простота и скорость разработки

• Быстрый старт для небольших проектов — не нужно конфигурировать сложную инфраструктуру
• Интуитивно понятная модель — объект сам управляет своим сохранением
• Меньше boilerplate-кода — сущности содержат как бизнес-логику, так и логику доступа к данным
• Быстрое прототипирование — идеально для MVP и небольших приложений

Прямой доступ к методам

// Всё в одном месте
$user = User::find($id); // Статический метод поиска
$user->update(['name' => 'John']);
$user->delete();

Недостатки Active Record

Нарушение принципа единой ответственности (SRP)

• Объект выполняет две задачи: представляет бизнес-сущность И управляет персистентностью
• Сложность тестирования — бизнес-логика тесно связана с инфраструктурой БД
• Нарушение инкапсуляции — данные и поведение смешиваются

Проблемы масштабирования

• Сложности с комплексными запросами — объекты "тянут" за собой связанные данные
• Сложная миграция на распределённые системы — привязка к одной БД
• Жёсткая связь с конкретной СУБД

Преимущества Data Mapper (Doctrine 2.x)

Чистая архитектура

• Соблюдение SRP — сущности отвечают только за бизнес-логику
• Отделение предметной области от инфраструктуры хранения данных
• Простое тестирование — можно тестировать сущности без БД

// Сущность не зависит от БД
class User {
    private $name;
    
    public function changeName(string $name): void {
        if (strlen($name) < 2) {
            throw new InvalidArgumentException('Имя слишком короткое');
        }
        $this->name = $name;
    }
}

Гибкость и расширяемость

• Несколько источников данных — можно использовать разные БД, API, файловые системы
• Сложные маппинги — поддержка наследования, встраиваемых объектов, кастомных типов
• Оптимизированные запросы — DQL, QueryBuilder для сложных выборок

// Сложный запрос через QueryBuilder
$query = $entityManager->createQueryBuilder()
    ->select('u', 'COUNT(p) as post_count')
    ->from(User::class, 'u')
    ->leftJoin('u.posts', 'p')
    ->where('u.active = :active')
    ->setParameter('active', true)
    ->groupBy('u.id')
    ->getQuery();

Производительность

• Отложенная загрузка (lazy loading) по умолчанию
• Кэширование запросов и результатов на разных уровнях
• Пакетная обработка операций

Недостатки Data Mapper

Сложность обучения

• Более крутая кривая обучения — нужно понимать Unit of Work, Identity Map и другие концепции
• Больше boilerplate-кода — отдельные репозитории, сервисы, конфигурации

# Дополнительная конфигурация в YAML
App\Entity\User:
    type: entity
    table: users
    id:
        id:
            type: integer
            generator:
                strategy: AUTO
    fields:
        username:
            type: string
            length: 255

Производительность на простых операциях

• Накладные расходы на поддержание Unit of Work
• Сложность в отладке — не всегда очевидно, когда произойдёт фактическое сохранение

Когда что выбирать?

Active Record подходит для:

• Небольших проектов и прототипов
• Простых CRUD-приложений
• Ситуаций, когда важна скорость разработки
• Проектов с простой предметной областью

Data Mapper предпочтителен для:

• Крупных корпоративных приложений
• Сложных предметных областей с богатой бизнес-логикой
• Проектов, требующих гибкости в источниках данных
• Приложений, где важна тестируемость и чистая архитектура

В современной PHP-экосистеме Doctrine с Data Mapper стал де-факто стандартом для серьёзных проектов благодаря своей гибкости, тестируемости и соответствию принципам чистой архитектуры. Однако для небольших задач иногда практичнее использовать более простые решения на основе Active Record, такие как Laravel Eloquent, который успешно сочетает простоту Active Record с некоторыми преимуществами Data Mapper.