#yiisoftActiveRecord #ПервыйРелиз #МажорныйРелиз #Релиз

🎁 Yii Active Record 1.0

Рады представить первый стабильный релиз Yii Active Record — реализация шаблона проектирования Active Record для PHP.

Пакет основан на Yii DB, то есть из коробки идёт поддержка основных реляционных СУБД: PostgreSQL, MySQL, MSSQL, Oracle, SQLite.

⭐️ Гибкая работа со свойствами модели

• Динамические свойства — быстрое прототипирование с #[\AllowDynamicProperties]
• Публичные свойства
• Защищённые свойства — инкапсуляция с геттерами/сеттерами
• Приватные свойства
• Магические свойства

⭐️ Мощная система связей

• Один-к-одному
• Один-ко-многим
• Многие-к-одному
• Многие-ко-многим — три способа реализации (промежуточная таблица, промежуточная модель, массив ключей)
• Глубокие связи — доступ к связанным записям через промежуточные отношения
• Обратные связи
• Жадная загрузка — решение проблемы N+1

⭐️ Расширяемость через трейты

• ArrayableTrait — конвертация модели в массив
• ArrayAccessTrait — доступ к свойствам через синтаксис массивов
• ArrayIteratorTrait — итерация по свойствам модели
• CustomConnectionTrait — кастомное подключение к БД
• EventsTrait — система событий и обработчиков
• FactoryTrait — интеграция с Yii Factory для DI
• MagicPropertiesTrait и MagicRelationsTrait — магические методы доступа
• RepositoryTrait — паттерн «Репозиторий»

⭐️ Дополнительные возможности

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

🖼 Пример

Пример AR-класса:

/**
 * Пользователь
 *
 * Поля, соответствующии БД:
 * @property int $id
 * @property string $username
 * @property string $email
 **/
#[\AllowDynamicProperties]
final class User extends \Yiisoft\ActiveRecord\ActiveRecord
{
    public function tableName(): string
    {
        return '{{%user}}';
    }
}

… и его использования:

// Создание новой записи в БД
$user = new User();
$user->set('username', 'alexander-pushkin');
$user->set('email', 'pushkin@example.com');
$user->save();

// Получение записи из БД
$user = User::query()->findByPk(1);

// Чтение свойств
$username = $user->get('username');
$email = $user->get('email');

#yiisoftDocs

📚 Yii3 Documentation

Запустили сайт c документацей по Yii3, которая включает в себя руководства, рецепты и внутренние документы для контрибьютеров.

⭐️ yiisoft.github.io/docs

Немного технических деталей:

• сайт хостится на Github Pages (репозиторий);

• в качестве генератора из Markdown используется VitePress;

• интернационализация реализована с помощью po4a.

Многое в документации уже описано, но кое-чего не хватает. Будем постепенно дорабатывать. Если нашли ошибки или чего-то не хватает — создавайте PR и/или тикеты, без помощи сообщества вытащить качественную документацию очень не просто.

#yiisoftDemoDiary

✨ Демо «Дневник»

Подготовили ещё одно демонстрационное приложение «Дневник» на базе Yii3, работает на PHP 8.5 + СУБД SQLite.

Приложение функционально полностью повторяет демо «Блог», но внутри сделано по-другому: применена архитектура «вертикальные срезы» и используется Active Record.

Запуск через Docker

# Склонировать репозиторий
git clone https://github.com/yiisoft/demo-diary.git

# Перейти в папку с приложением
cd demo-diary

# Подготовить приложение к запуску (образ, пакеты)
make init

# Применить миграции
make migrate-up

# Наполнить тестовыми данными (опционально)
make fake-data

# Запустить приложение
make up

Приложение будет доступно по адресу http://127.0.0.1:8080/.

Доступ администратора: admin / q1w2e3r4

Демо «Блог» тоже доработали, сделав один контекст, чтобы получилось более простое и понятное приложение со слоями и паттернами DDD.

Критикуйте, хвалите, предлагайте улучшения ☺️

📚 Документация по API Yii3-пакетов

Добавили на сайте yiiframework.com документацию по API Yii3-пакетов.

Документация генерируется автоматически с помощью yiisoft/yii2-apidoc на основании исходного кода. Анализируются классы, свойства и методы и подтягивается дополнительная информация из PHPDoc.

#news

🚀 Yii3 is now available!

• Yii3 landing page
• Official announce
• Documentation
• Application templates: Web, API, Console
• Demo applications: Blog (Layered DDD), Diary (Vertical slices, Active Record)

Thank you for your support and patience! We did it together. All the core team members, community contributors, and backers
🤝

We're pretty sure the Yii3 codebase will serve us well in at least the next 10 years or even more.

Merry Christmas and Happy New Year! Enjoy! 🎉