Exemple #1
0
 /**
  *  <h1>Описание</h1>
  *  <pre>
  *    Провести авторизацию и выполнить команду
  *  </pre>
  *  <h1>Что возвращает</h1>
  *  <pre>
  *    - JSON-массив:
  *
  *      [
  *        "status"        // Статус результата выполнения команды
  *        "timestamp"     // Timestamp прихода запроса от клиента
  *        "data"          // Данные
  *      ]
  *  </pre>
  *  <h1>Какие статусы бывают, зависимость data от статуса</h1>
  *  <pre>
  *    0   // Команда выполнена успешно. В data результаты её выполненя.
  *    -1  // Нет доступа. В data строка-сообщение об этом.
  *    -2  // Команда завершилась с ошибкой. В data текст ошибки.
  *  </pre>
  *  <h1>Примеры использования</h1>
  *  <pre>
  *
  *    1. Синхронное выполнение
  *
  *      1.1. Простой синхронный запуск
  *        runcommand('\M1\Commands\C1_parseapp');
  *
  *      1.2. С передачей данных
  *        runcommand('\M1\Commands\C1_parseapp', ['key1'=>'value1','key2'=>'value2']);
  *
  *      1.3. С авторизацией по ID текущего пользователя (ID == "15" в примере)
  *        runcommand('\M1\Commands\C1_parseapp', [], 15);
  *
  *    2. Добавление в очередь задач
  *
  *      2.1. Без дополнительной отсрочки выполнения
  *      runcommand('\M1\Commands\C1_parseapp', [], "", ['on'=>true, 'delaysecs'=>'']);
  *
  *      2.2. С дополнительной отсрочкой выполнения в 10 секунд
  *      runcommand('\M1\Commands\C1_parseapp', [], "", ['on'=>true, 'delaysecs'=>'10']);
  *
  *  </pre>
  *
  * @param  mixed $command
  * @param  array $data
  * @param  mixed $userid
  * @param  mixed $queue
  *
  * @return mixed
  */
 function runcommand($command, $data = [], $userid = 0, $queue = ['on' => false, 'delaysecs' => '', 'name' => 'default'])
 {
     // 1. Провести exec-авторизацию, если она включена
     if (config("M5.authorize_exec_ison") == true) {
         // 1.1. Если $userid == -1
         // - Вернуть ответ со статусом -1 (доступ запрещён)
         if ($userid == -1) {
             return ["status" => -1, "data" => $command];
         } else {
             $validator = r4_validate(['userid' => $userid], ["userid" => ["required", "regex:/^[0-9]+\$/ui"]]);
             if ($validator['status'] == -1) {
                 return ["status" => -1, "data" => $command];
             }
         }
         // 1.3. Если $userid !== 0, то провести exec-авторизацию
         if ($userid !== 0) {
             // 1] Извлечь из сессии значение по ключу "authorize_exec"
             $authorize_exec = session('authorize_exec');
             // 2] Провести валидацию $authorize_exec
             $is_authorize_exec_valid = call_user_func(function () use($authorize_exec) {
                 // 2.1] Если $authorize_exec пусто, вернуть false
                 if (empty($authorize_exec)) {
                     return false;
                 }
                 // 2.2] Если $authorize_exec не массив строк, вернуть false
                 $validator = r4_validate(['authorize_exec' => $authorize_exec], ["authorize_exec" => ["required", "array"], "authorize_exec.*" => ["string"]]);
                 if ($validator['status'] == -1) {
                     return false;
                 }
                 // 2.3] Вернуть true
                 return true;
             });
             // 3] Искать $command в $authorize_exec
             // - Если $authorize_exec не пусто и валидно.
             // - Если права нет, вернуть статус -1 (доступ запрещён).
             if ($is_authorize_exec_valid) {
                 if (!in_array($command, $authorize_exec)) {
                     return ["status" => -1, "data" => $command];
                 }
             } else {
                 // 4.1] Получить коллекцию всех команд, которые $userid может выполнять
                 $commands = call_user_func(function () use($userid) {
                     // 4.1.1] Попробовать найти пользователя $userid
                     // - Если найти его не удастся, вернуть пустую коллекцию.
                     $user = \M5\Models\MD1_users::find($userid);
                     if (empty($user)) {
                         return collect([]);
                     }
                     // 4.1.2] Получить коллекцию всех exec-прав, связанных с $user
                     $privileges = call_user_func(function () use($user) {
                         // 1) Состоит ли $user в любой административной группе?
                         $admingroup = \M5\Models\MD2_groups::where('isadmin', 1)->whereHas('users', function ($query) use($user) {
                             $query->where('id', $user->id);
                         })->first();
                         // 2) Если состоит, вернуть все exec-права
                         if (!empty($admingroup)) {
                             return \M5\Models\MD3_privileges::whereHas('privtypes', function ($query) {
                                 $query->where('name', 'exec');
                             })->get();
                         } else {
                             return \M5\Models\MD3_privileges::whereHas('privtypes', function ($query) {
                                 $query->where('name', 'exec');
                             })->where(function ($query) use($user) {
                                 // Права, прямо связанные с пользователем
                                 $query->whereHas('users', function ($query) use($user) {
                                     $query->where('id', $user->id);
                                 });
                                 // Права, связанные с группами, с которыми связан пользователь
                                 $query->orWhereHas('groups', function ($query) use($user) {
                                     $query->whereHas('users', function ($query) use($user) {
                                         $query->where('id', $user->id);
                                     });
                                 });
                                 // Права, связанные с тегами, с которыми связан пользователь
                                 $query->orWhereHas('tags', function ($query) use($user) {
                                     $query->whereHas('users', function ($query) use($user) {
                                         $query->where('id', $user->id);
                                     });
                                 });
                                 // Права, связанные с тегами, связанные с группами, с которыми связан пользователь.
                                 $query->orWhereHas('tags', function ($query) use($user) {
                                     $query->whereHas('groups', function ($query) use($user) {
                                         $query->whereHas('users', function ($query) use($user) {
                                             $query->where('id', $user->id);
                                         });
                                     });
                                 });
                             })->get();
                         }
                     });
                     // 4.1.3] Если у модели MD5_commands в M1 нет связи m5_privileges
                     // - Вернуть пустую коллекцию.
                     if (!r1_rel_exists("m1", "md5_commands", "m5_privileges")) {
                         return collect([]);
                     }
                     // 4.1.4] В противном случае, вернуть коллекцию соотв.команд
                     $commands = r1_query(function () use($privileges) {
                         return \M1\Models\MD5_commands::with(['packages'])->where(function ($query) use($privileges) {
                             $query->whereHas('m5_privileges', function ($query) use($privileges) {
                                 $query->whereIn('id', $privileges->pluck('id'));
                             });
                         })->get();
                     });
                     if (!$commands) {
                         return collect([]);
                     } else {
                         return $commands;
                     }
                 });
                 // 4.2] Превратить $commands в массив полн.квалиф.команд
                 $commands_final = call_user_func(function () use($commands) {
                     // 4.2.1] Если $commands эта пустая коллекция, вернуть пустой массив
                     if (count($commands) == 0) {
                         return [];
                     }
                     // 4.2.2] Подготовить массив для результата
                     $result = [];
                     // 4.2.3] Пробежаться по $commands и наполнить $result
                     $commands->each(function ($item) use(&$result) {
                         array_push($result, "\\" . $item->packages[0]->id_inner . "\\Commands\\" . $item->name);
                     });
                     // 4.2.n] Вернуть результат
                     return $result;
                 });
                 // 4.3] Перезаписать в сессии кэш authorize_exec
                 session(['authorize_exec' => $commands_final]);
                 // 4.4] Если $command не в $commands_final
                 // - Вернуть статус -1 (нет доступа).
                 if (!in_array($command, $commands_final)) {
                     return ["status" => -1, "data" => $command];
                 }
             }
         }
     }
     // 2. Выполнить команду $command
     // - Передав ей данные $data
     // 2.1. Синхронно, если иное не указано в 4-м аргументе runcommand
     if ($queue['on'] == false) {
         $result = Bus::dispatch(new $command($data));
     } else {
         // 1] Без задержки
         if (empty($queue['delaysecs'])) {
             Queue::push(new $command($data), [], $queue['name']);
         } else {
             Queue::later($queue['delaysecs'], new $command($data), [], $queue['name']);
         }
     }
     // 3. Подготовить массив с ответом, и вернуть
     // 3.1. Если команда выполняется синхронно
     if ($queue['on'] == false) {
         $response = ["status" => $result['status'], "data" => $result['data']];
         if (array_key_exists('timestamp', $data)) {
             $response['timestamp'] = $data['timestamp'];
         }
         return $response;
     }
     // 3.2. Если команда выполняется асинхронно
     if ($queue['on'] == true) {
         $response = ["status" => 0, "data" => ""];
         if (array_key_exists('timestamp', $data)) {
             $response['timestamp'] = $data['timestamp'];
         }
         return $response;
     }
 }