. */ declare(strict_types=1); namespace FireflyIII\Validation; use FireflyIII\Models\TransactionGroup; use Illuminate\Validation\Validator; use Log; /** * Trait GroupValidation. * * This trait combines some of the validation methods used to validate if journal and group data is submitted correctly. */ trait GroupValidation { /** * @param Validator $validator * * @return array */ abstract protected function getTransactionsArray(Validator $validator): array; /** * This method validates if the user has submitted transaction journal ID's for each array they submit, if they've submitted more than 1 transaction * journal. This check is necessary because Firefly III isn't able to distinguish between journals without the ID. * * @param Validator $validator * @param TransactionGroup $transactionGroup */ protected function validateJournalIds(Validator $validator, TransactionGroup $transactionGroup): void { Log::debug(sprintf('Now in GroupValidation::validateJournalIds(%d)', $transactionGroup->id)); $transactions = $this->getTransactionsArray($validator); if (count($transactions) < 2) { // no need for validation. return; } // check each array: /** * @var int $index * @var array $transaction */ foreach ($transactions as $index => $transaction) { $this->validateJournalId($validator, $index, $transaction, $transactionGroup); } } /** * Adds an error to the "description" field when the user has submitted no descriptions and no * journal description. * * @param Validator $validator */ protected function validateDescriptions(Validator $validator): void { Log::debug('Now in GroupValidation::validateDescriptions()'); $transactions = $this->getTransactionsArray($validator); $validDescriptions = 0; foreach ($transactions as $transaction) { if ('' !== (string)($transaction['description'] ?? null)) { $validDescriptions++; } } // no valid descriptions? if (0 === $validDescriptions) { $validator->errors()->add( 'transactions.0.description', (string)trans('validation.filled', ['attribute' => (string)trans('validation.attributes.description')]) ); } } /** * Do the validation required by validateJournalIds. * * @param Validator $validator * @param int $index * @param array $transaction * @param TransactionGroup $transactionGroup * * @SuppressWarnings(PHPMD.CyclomaticComplexity) */ private function validateJournalid(Validator $validator, int $index, array $transaction, TransactionGroup $transactionGroup): void { $journalId = $transaction['transaction_journal_id'] ?? null; $journalId = null === $journalId ? null : (int) $journalId; $count = $transactionGroup->transactionJournals()->where('id', $journalId)->count(); if (null === $journalId || (null !== $journalId && 0 !== $journalId && 0 === $count)) { $validator->errors()->add(sprintf('transactions.%d.source_name', $index), (string) trans('validation.need_id_in_edit')); } } /** * @param Validator $validator */ protected function validateGroupDescription(Validator $validator): void { Log::debug('Now in validateGroupDescription()'); $data = $validator->getData(); $transactions = $this->getTransactionsArray($validator); $groupTitle = $data['group_title'] ?? ''; if ('' === $groupTitle && count($transactions) > 1) { $validator->errors()->add('group_title', (string) trans('validation.group_title_mandatory')); } } }