⚡️ #yiisoftMutex

В документации к Yii Mutex добавлено предупреждение об особенностях использования деструкторов и shutdown-функций (PR).

—————

Выдержки из документации PHP

• register_shutdown_function(): "Возможна регистрация нескольких подобных функций с помощью register_shutdown_function(), при этом функции будут выполняться в том порядке, в каком они были зарегистрированы. Если вы вызовете exit() в одной из зарегистрированных завершающих функций, процесс будет полностью остановлен и последующие завершающие функции не будут вызваны."

• __destruct(): "Деструктор будет вызываться даже в том случае, если скрипт был остановлен с помощью функции exit(). Вызов exit() в деструкторе предотвратит запуск всех последующих функций завершения."

—————

Если в пользовательском коде или в других пакетах внутри деструктора или shutdown-функции работа скрипта будет остановлена с помощью die() или exit(), то автоматическое снятие блокировки в мьютексе может не сработать.

⚡️ #yiisoftMutex

В классе SimpleMutex из Yii Mutex реализовано автоматические удаление объекта мьютекса после снятия блокировки (PR).

⚡️ #yiisoftMutexFile

Навели порядок в пакете Yii Mutex File Driver (PR):

- подчищен код, улучшены doc-блоки;
- обновлены dev-зависимости;
- уровень psalm повышен до 1;
- добавлены тесты;
- в файле .editorconfig добавлена секция *.yml;
- исключены все служебные файлы при создании архива репозитория;
- актуализирован readme;
- улучшены конфигурация GitHub Workflow и другие служебные файлы.

⚡️ #yiisoftMutex

Небольшой рефакторинг тестов в Yii Mutex: удалён трейт MutexTestTrait, а все тесты из него перенесены в сам класс с тестами (PR).

⚡️ #yiisoftFactory

При создании объекта с помощью фабрики из пакета Yii Factory, в случае возникновения циклической зависимости (на любом уровне вложенности), теперь выбрасывается исключение CircularReferenceException (PR).

Пример:

final class Chicken
{
    public function __construct(Egg $egg)
    {
    }
}

final class Egg
{
    public function __construct(Chicken $chicken)
    {
    }
}

// Будет выброшено исключение `CircularReferenceException`
$factory->create(Chicken::class);

⚡️ #yiisoftMutexPdoMysql

Навели порядок в пакете Yii Mutex MySQL PDO Driver (PR):

- подчищен код, улучшены doc-блоки;
- обновлены dev-зависимости;
- уровень psalm повышен до 1;
- добавлены тесты;
- в файле .editorconfig добавлена секция *.yml;
- исключены все служебные файлы при создании архива репозитория;
- актуализирован readme;
- улучшены конфигурация GitHub Workflow и другие служебные файлы.

⚡️ #yiisoftDi

В пакете Yii Dependency Injection исправлена критичная ошибка в бенчмарках (PR): замеры проводилось без получения зависимостей.

⚡️ #yiisoftMutex

В пакете Yii Mutex добавлен абстрактный класс Mutex (реализует MutexInterface), предоставляющий базовый функционал для создания драйверов (PR).

⚡️#yiisoftMutexPdoPgsql

Исправлена опечатка в имени исключения, вызываемого в случае неудачного снятия блокировки в пакете Yii Mutex Postgres PDO Driver (PR).

Спасибо Максиму Сторчаку за выявленную ошибку и PR 👍

⚡️ #yiisoftApp #yiisoftAppApi #yiisoftDemo #yiisoftDemoApi

В приложениях конфигурация начальной загрузки (bootstrap) разделена на общую, консольную и web-части:

- шаблон веб-приложения (PR),
- шаблон API-приложения (PR),
- демо веб-приложения (PR),
- демо API-приложения (PR).

Bootstrap представляет собой массив функций (точнее callable) вида function (ContainerInterface $container): void, которые последовательно будут вызваны при запуске приложения.

⚡️ #yiisoftFactory

Подчистили код ссылок (Reference) в Yii Factory (PR):

• Удалён метод Reference::getId() (нигде не использовался).

• Изменён тип результата в методах Reference::to() и DynamicReference::to() с ReferenceInterface на self.

• Улучшены описания в doc-блоках.

⚡️ #yiisoftDi #yiisoftDataResponse

В пакете Yii Dependency Injection добавлены хелперы ReferencesArray и DynamicReferencesArray для создания массива обычных (Reference) и динамических (DynamicReference) ссылок соответственно (PR).

Хелперы удобно использовать в конфигурациях. Так, в пакете Yii Data Response вынесли форматеры мидлвари ContentNegotiator в параметры, используя класс DynamicReferencesArray (PR).

Было:

// Конфигурация web.php
ContentNegotiator::class => [
  '__construct()' => [
    'contentFormatters' => [
      'text/html' => new HtmlDataResponseFormatter(),
      'application/xml' => new XmlDataResponseFormatter(),
      'application/json' => new JsonDataResponseFormatter(),
    ],
  ],
],

Стало:

// Конфигурация web.php
ContentNegotiator::class => [
  '__construct()' => [
    'contentFormatters' => DynamicReferencesArray::from($params['yiisoft/data-response']['contentFormatters']),
  ],
],

// Параметры params.php
'yiisoft/data-response' => [
  'contentFormatters' => [
    'text/html' => HtmlDataResponseFormatter::class,
    'application/xml' => XmlDataResponseFormatter::class,
    'application/json' => JsonDataResponseFormatter::class,
  ],
],

⚡️ #yiisoftFactory

Небольшой рефакторинг в Yii Factory: в классе Factory приватное свойство $container переименовано в более логичное $dependencyResolver (PR).

⚡️ #yiisoftFactory

Несколько доработок в Yii Factory (PR):

• При разрешении зависимостей фабрика теперь не пытается передать null для параметров, которые не поддерживают его, а сразу кидает исключение. Аналогично будет работать в контейнере зависимостей, так как в этой части он использует код из Yii Factory.

• Исключение CircularReferenceException теперь наследуется от NotInstantiableException.

• Добавлено исключение NotInstantiableClassException.

• В GitHub Actions добавлен статический анализ в PHP 8.

На картинке изображена диаграмма классов исключений из пакета Yii Factory на данный момент.

⚡️ #yiisoftYiiDevTool

Доработан инструмент для разработки Yii Dev Tool: теперь его можно использовать для любого вендора, а не только для yiisoft (PR).

⚡️ #yiisoftMutex

В абстрактном классе Mutex (пакет Yii Mutex) финализирован деструктор (PR).

⚡️ #yiisoftMutexFile

В пакете Yii Mutex File Driver мьютекс теперь наследуется от абстрактного Mutex из основного пакета + настройки мьютекса перенесены из сеттеров в конструктор (PR).

⚡️ #yiisoftMutexPdoMysql

В пакете Yii Mutex MySQL PDO Driver мьютекс теперь наследуется от абстрактного Mutex из основного пакета + в работе драйвера удалена проверка с использованием MySQL-функции IS_FREE_LOCK() (PR).

⚡️ #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle

Навели порядок в пакетах Yii Mutex Oracle PDO Driver (PR) и Yii Mutex Postgres PDO Driver (PR):

- класс мьютекса наследуется от Mutex из основного пакета;
- подчищен код, улучшены doc-блоки;
- обновлены dev-зависимости;
- уровень psalm повышен до 1;
- добавлены тесты;
- в файле .editorconfig добавлена секция *.yml;
- исключены все служебные файлы при создании архива репозитория;
- актуализирован readme;
- улучшены конфигурация GitHub Workflow и другие служебные файлы.

⚡️ #yiisoftEventDispatcher

В пакете Yii Event Dispatcher при добавлении слушателя в коллекцию для случаев, когда не указан тип события в слушателе и когда слушатель не содержит события, выводятся разные сообщения об ошибке (PR).