Samoyed CMG – API Generator

// Эта анонимная функция определяет список параметров функции API
// Параметр с именем return указывает тип возвращаемого значения
return function (int $page, int $perPage, array $return): \Closure {
    // Эта анонимная функция определяет функцию, которая выполняет группировку вызовов всех функций API
    // Параметр $fnCalls опреляет тип функции Calls[Get|Put|Lifetime|Direct]
    // $fnCalls является итерируемым объектом и позволяет перебирать все вызовы
    return function (CallsLifetime $fnCalls, IDatabase $database): void {
        // Создаём объект для кеширования вызовов в памяти
        $cacheCall = new CacheCall();
        // Перебираем все вызовы
        foreach ($fnCalls as $fnCall) {
            // Установить время жизни для вызова функции $fnCall КЕШ-а = 5 минут
            $fnCall->setTtl(5 * 60);
            // Выбрать список идентификаторов статей по входным параметрам функции API: page и perPage (и завешировать результат в памяти)
            $articles = $cacheCall($fnCall->arg('page'), $fnCall->arg('perPage'), function (int $page, int $perPage) use ($database) {
                return $database->select('articles', 'id')->orderBy('id', false)->pagination($perPage, $page);
            });
            // Для каждого идентификатора статьи вызвать функцию получения статьи
            $waits = [];
            foreach ($articles->items() as $article) {
                $waits[] = $fnCall->fns()->articleGet($article['id']);
            }
            // Ждать завершения выполнения всех функций
            $fnCalls->all($waits)->wait(function ($items, $err) use ($fnCall, $articles) {
                // Вернуть результат (точнее установить результат)
                $fnCall->setValue($articles->args($items));
            });
        }
    };
};

// Эта анонимная функция определяет список параметров функции API
// Параметр с именем return указывает тип возвращаемого значения
return function (int $id, array $return): \Closure {
    // Эта анонимная функция определяет функцию, которая выполняет группировку вызовов всех функций API
    // Параметр $fnCalls опреляет тип функции Calls[Get|Put|Lifetime|Direct]
    // $fnCalls является итерируемым объектом и позволяет перебирать все вызовы
    return function (CallsGet $fnCalls, IDatabase $database): void {
        // Выбрать информацию о статьях
        // $fnCalls->args() - получает список параметров всех вызовов
        // ArrArr::value('id', $fnCalls->args()) - получает уникальные значения параметра id
        // ArrArr::groupBy('id', ...) - группировать массив по полю id
        $articles = ArrArr::groupBy('id', $database->select('articles')->in('id', ArrArr::value('id', $fnCalls->args()))->get());
        // Разобрать выбранные данные по вызовам API функций
        foreach ($fnCalls as $fnCall) {
            // Информция о статье
            $article = $articles[$fnCall->arg('id')];
            // Указать зависимость вызова от функции PUT
            // Т.е. при вызове функции articlePut с указанным параметром КЕШ функции $fnCall будет сброшен
            $fnCall->fns()->articlePut($article['id']);
            // Выбрать информацию о пользователе
            $fnCall->fns()->userGet($article['author_id'])->wait(function ($value, $err) use ($article, $fnCall) {
                // Информация о пользователе
                $article['author'] = $value;
                // Установить значение функции
                $fnCall->setValue($article);
            });
        }
    };
};

// Эта анонимная функция определяет список параметров функции API
// Параметр с именем return указывает тип возвращаемого значения
return function (int $id, array $return): \Closure {
    // Эта анонимная функция определяет функцию, которая выполняет группировку вызовов всех функций API
    // Параметр $fnCalls опреляет тип функции Calls[Get|Put|Lifetime|Direct]
    // $fnCalls является итерируемым объектом и позволяет перебирать все вызовы
    return function (CallsGet $fnCalls, IDatabase $database): void {
        // Выбрать список уникальных идентификаторов пользователей
        $author_ids = ArrArr::value('id', $fnCalls->args());
        // Выбрать информацию о пользователях
        $users = ArrArr::groupBy('id', $database->select('users')->in('id', $author_ids)->get());
        // Разобрать выбранные данные по вызовам
        foreach ($fnCalls as $fnCall) {
            // Информация о пользователе с идентификатором вызова $fnCall->arg('id')
            $user = $users[$fnCall->arg('id')];
            // Указать зависимость вызова от функции PUT
            $fnCall->fns()->userPut($user['id']);
            // Установить значение функции
            $fnCall->setValue($user);
        }
    };
};