Первичная реализация формы отправки нового письма с активацией аккаунта, чуть-чуть рефакторинга тестов

api/controllers/SignupController.php

@@ -2,6 +2,7 @@
 namespace api\controllers;
 
 use api\models\ConfirmEmailForm;
+use api\models\NewAccountActivationForm;
 use api\models\RegistrationForm;
 use Yii;
 use yii\filters\AccessControl;
@@ -12,13 +13,13 @@ class SignupController extends Controller {
     public function behaviors() {
         return ArrayHelper::merge(parent::behaviors(), [
             'authenticator' => [
-                'except' => ['index', 'confirm'],
+                'except' => ['index', 'new-message', 'confirm'],
             ],
             'access' => [
                 'class' => AccessControl::class,
                 'rules' => [
                     [
-                        'actions' => ['index', 'confirm'],
+                        'actions' => ['index', 'new-message', 'confirm'],
                         'allow' => true,
                         'roles' => ['?'],
                     ],
@@ -31,6 +32,7 @@ class SignupController extends Controller {
         return [
             'register' => ['POST'],
             'confirm' => ['POST'],
+            'new-message' => ['POST'],
         ];
     }
 
@@ -49,6 +51,31 @@ class SignupController extends Controller {
         ];
     }
 
+    public function actionNewMessage() {
+        $model = new NewAccountActivationForm();
+        $model->load(Yii::$app->request->post());
+        if (!$model->sendNewMessage()) {
+            $response = [
+                'success' => false,
+                'errors' => $this->normalizeModelErrors($model->getErrors()),
+            ];
+
+            if ($response['errors']['email'] === 'error.recently_sent_message') {
+                $activeActivation = $model->getActiveActivation();
+                $response['data'] = [
+                    'can_repeat_in' => $activeActivation->created_at - time() + NewAccountActivationForm::REPEAT_FREQUENCY,
+                    'repeat_frequency' => NewAccountActivationForm::REPEAT_FREQUENCY,
+                ];
+            }
+
+            return $response;
+        }
+
+        return [
+            'success' => true,
+        ];
+    }
+
     public function actionConfirm() {
         $model = new ConfirmEmailForm();
         $model->load(Yii::$app->request->post());

api/models/BaseKeyConfirmationForm.php

@@ -11,6 +11,7 @@ class BaseKeyConfirmationForm extends BaseApiForm {
 
     public function rules() {
         return [
+            // TODO: нужно провалидировать количество попыток ввода кода для определённого IP адреса и в случае чего запросить капчу
             ['key', 'required', 'message' => 'error.key_is_required'],
             ['key', 'validateKey'],
         ];

api/models/NewAccountActivationForm.php

@@ -0,0 +1,103 @@
+<?php
+namespace api\models;
+
+use common\components\UserFriendlyRandomKey;
+use common\models\Account;
+use common\models\EmailActivation;
+use Yii;
+use yii\base\ErrorException;
+
+class NewAccountActivationForm extends BaseApiForm {
+
+    // Частота повтора отправки нового письма
+    const REPEAT_FREQUENCY = 5 * 60;
+
+    public $email;
+
+    public function rules() {
+        return [
+            ['email', 'filter', 'filter' => 'trim'],
+            ['email', 'required', 'message' => 'error.email_required'],
+            ['email', 'validateAccountForEmail'],
+            ['email', 'validateExistsActivation'],
+        ];
+    }
+
+    public function validateAccountForEmail($attribute) {
+        if (!$this->hasErrors($attribute)) {
+            $account = $this->getAccount();
+            if ($account && $account->status === Account::STATUS_ACTIVE) {
+                $this->addError($attribute, "error.account_already_activated");
+            } elseif (!$account) {
+                $this->addError($attribute, "error.{$attribute}_not_found");
+            }
+        }
+    }
+
+    public function validateExistsActivation($attribute) {
+        if (!$this->hasErrors($attribute)) {
+            if ($this->getActiveActivation() !== null) {
+                $this->addError($attribute, 'error.recently_sent_message');
+            }
+        }
+    }
+
+    public function sendNewMessage() {
+        if (!$this->validate()) {
+            return false;
+        }
+
+        $account = $this->getAccount();
+        $transaction = Yii::$app->db->beginTransaction();
+        try {
+            // Удаляем все активации аккаунта для пользователя этого E-mail адреса
+            /** @var EmailActivation[] $activations */
+            $activations = $account->getEmailActivations()
+                ->andWhere(['type' => EmailActivation::TYPE_REGISTRATION_EMAIL_CONFIRMATION])
+                ->all();
+
+            foreach ($activations as $activation) {
+                $activation->delete();
+            }
+
+            $activation = new EmailActivation();
+            $activation->account_id = $account->id;
+            $activation->type = EmailActivation::TYPE_REGISTRATION_EMAIL_CONFIRMATION;
+            $activation->key = UserFriendlyRandomKey::make();
+            if (!$activation->save()) {
+                throw new ErrorException('Unable save email-activation model.');
+            }
+
+            $regForm = new RegistrationForm();
+            $regForm->sendMail($activation, $account);
+
+            $transaction->commit();
+        } catch (ErrorException $e) {
+            $transaction->rollBack();
+            throw $e;
+        }
+
+        return true;
+    }
+
+    /**
+     * @return Account|null
+     */
+    public function getAccount() {
+        return Account::find()
+               ->andWhere(['email' => $this->email])
+               ->one();
+    }
+
+    /**
+     * @return EmailActivation|null
+     */
+    public function getActiveActivation() {
+        return $this->getAccount()
+            ->getEmailActivations()
+            ->andWhere(['type' => EmailActivation::TYPE_REGISTRATION_EMAIL_CONFIRMATION])
+            ->andWhere(['>=', 'created_at', time() - self::REPEAT_FREQUENCY])
+            ->one();
+    }
+
+}

api/models/RegistrationForm.php

@@ -82,25 +82,7 @@ class RegistrationForm extends BaseApiForm {
                 throw new ErrorException('Unable save email-activation model.');
             }
 
-            /** @var \yii\swiftmailer\Mailer $mailer */
-            $mailer = Yii::$app->mailer;
-            /** @var \yii\swiftmailer\Message $message */
-            $message = $mailer->compose(
-                [
-                    'html' => '@app/mails/registration-confirmation-html',
-                    'text' => '@app/mails/registration-confirmation-text',
-                ],
-                [
-                    'key' => $emailActivation->key,
-                ]
-            )
-                ->setTo([$account->email => $account->username])
-                ->setFrom([Yii::$app->params['fromEmail'] => 'Ely.by Accounts'])
-                ->setSubject('Ely.by Account registration');
-
-            if (!$message->send()) {
-                throw new ErrorException('Unable send email with activation code.');
-            }
+            $this->sendMail($emailActivation, $account);
 
             $transaction->commit();
         } catch (ErrorException $e) {
@@ -111,4 +93,24 @@ class RegistrationForm extends BaseApiForm {
         return $account;
     }
 
+    // TODO: подумать, чтобы вынести этот метод в какую-то отдельную конструкцию, т.к. используется и внутри NewAccountActivationForm
+    public function sendMail(EmailActivation $emailActivation, Account $account) {
+        /** @var \yii\swiftmailer\Mailer $mailer */
+        $mailer = Yii::$app->mailer;
+        /** @var \yii\swiftmailer\Message $message */
+        $message = $mailer->compose([
+            'html' => '@app/mails/registration-confirmation-html',
+            'text' => '@app/mails/registration-confirmation-text',
+        ], [
+                'key' => $emailActivation->key,
+            ])
+            ->setTo([$account->email => $account->username])
+            ->setFrom([Yii::$app->params['fromEmail'] => 'Ely.by Accounts'])
+            ->setSubject('Ely.by Account registration');
+
+        if (!$message->send()) {
+            throw new ErrorException('Unable send email with activation code.');
+        }
+    }
+
 }