Начало работы по #5 и #6

- строгая типизация - переработан класс `TestEnvParams`: - вынесен на уровень выше из под `AtolOnline\Constants` - вместо констант - две функции для получения актуальных параметров подключения по ФФД1.05 и ФФД1.2 - актуализированы `PaymentObjects` согласно #5 - исходники вынесены не уровень выше в `src` - константы теперь enum через `myclabs/php-enum` - новые константы `DocumentTypes` - классы констант финализированы - все исключения переименованы, а многие так или иначе отрефакторены (не полностью) - новые исключения `InvalidSnoException`, `InvalidPaymentAddressException` - `helpers.php` стал полноценным классом `Helpers` - удалены трейты `HasEmail`, `HasInn`, `RublesKopeksConverter` (конвертация перенесена в `Helpers`) - удалён хелпер `valid_strlen()`, вместо него теперь везде `mb_strlen()` - сущности `Client` и `Company` получили свои имплементации для `email` и `inn` - доработки в `BasicTestCase` - полное покрытие тестами: `Client`, `Company`, `Helpers` - поправлен `phpunit.xml` - везде обновлены копирайты - актуализированы и исправлены phpdoc, return types - начато введение `strict_types=1` - минимальный php теперь 8.0 - обновлены все зависимости - подключен пакет коллекций laravel для будущего использования - теперь можно `composer test` и `composer test-cov`
2021-11-18 12:24:30 +08:00
parent cc944a1dbb
commit 77481884ad
78 changed files with 4220 additions and 2712 deletions
--- a/src/Entities/VatArray.php
+++ b/src/Entities/VatArray.php
@@ -0,0 +1,117 @@
+<?php
+/*
+ * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
+ *
+ * This code is licensed under MIT.
+ * Этот код распространяется по лицензии MIT.
+ * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
+ */
+
+declare(strict_types = 1);
+
+namespace AtolOnline\Entities;
+
+use AtolOnline\Exceptions\TooManyVatsException;
+
+/**
+ * Класс, описывающий массив ставок НДС
+ *
+ * @package AtolOnline\Entities
+ */
+class VatArray extends Entity
+{
+    /**
+     * Максимальное количество элементов массива
+     */
+    public const MAX_COUNT = 6;
+    
+    /**
+     * @var Vat[] Массив ставок НДС
+     */
+    private array $vats = [];
+
+    /**
+     * VatArray constructor.
+     *
+     * @param Vat[]|null $vats Массив ставок НДС
+     * @throws TooManyVatsException Слишком много ставок НДС
+     */
+    public function __construct(?array $vats = null)
+    {
+        if ($vats) {
+            $this->set($vats);
+        }
+    }
+
+    /**
+     * Устанавливает массив ставок НДС
+     *
+     * @param Vat[] $vats Массив ставок НДС
+     * @return $this
+     * @throws TooManyVatsException Слишком много ставок НДС
+     */
+    public function set(array $vats): VatArray
+    {
+        if ($this->validateCount($vats)) {
+            $this->vats = $vats;
+        }
+        return $this;
+    }
+
+    /**
+     * Добавляет новую ставку НДС в массив
+     *
+     * @param Vat $vat Объект ставки НДС
+     * @return $this
+     * @throws TooManyVatsException Слишком много ставок НДС
+     */
+    public function add(Vat $vat): VatArray
+    {
+        if ($this->validateCount()) {
+            if (isset($this->vats[$vat->getType()])) {
+                $this->vats[$vat->getType()]->addSum($vat->getSum());
+            } else {
+                $this->vats[$vat->getType()] = $vat;
+            }
+        }
+        return $this;
+    }
+    
+    /**
+     * Возвращает массив ставок НДС
+     *
+     * @return Vat[]
+     */
+    public function get(): array
+    {
+        return $this->vats;
+    }
+    
+    /**
+     * @inheritDoc
+     */
+    public function jsonSerialize()
+    {
+        $result = [];
+        foreach ($this->get() as $vat) {
+            $result[] = $vat->jsonSerialize();
+        }
+        return $result;
+    }
+
+    /**
+     * Проверяет количество налоговых ставок
+     *
+     * @param Vat[]|null $vats Если передать массив, то проверит количество его элементов.
+     *                         Иначе проверит количество уже присвоенных элементов.
+     * @return bool true если всё хорошо, иначе выбрасывает исключение
+     * @throws TooManyVatsException Слишком много ставок НДС
+     */
+    protected function validateCount(?array $vats = null): bool
+    {
+        if ((!empty($vats) && count($vats) >= self::MAX_COUNT) || count($this->vats) >= self::MAX_COUNT) {
+            throw new TooManyVatsException(count($vats), self::MAX_COUNT);
+        }
+        return true;
+    }
+}