Начало работы по #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`

tests/BasicTestCase.php

@@ -1,12 +1,16 @@
 <?php
-/**
- * Copyright (c) Антон Аксенов (aka Anthony Axenov)
+/*
+ * 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\Tests;
+
 use AtolOnline\Entities\Entity;
 use PHPUnit\Framework\TestCase;
 
@@ -16,7 +20,7 @@ use PHPUnit\Framework\TestCase;
 class BasicTestCase extends TestCase
 {
     /**
-     *
+     * @todo требуется рефакторинг
      */
     public function setUp(): void
     {
@@ -26,38 +30,56 @@ class BasicTestCase extends TestCase
         defined('ATOL_KKT_PASS') ?: define('ATOL_KKT_PASS', 'iGFFuihss');
         defined('ATOL_CALLBACK_URL') ?: define('ATOL_CALLBACK_URL', 'http://example.com/callback');
     }
-    
+
     /**
+     * Тестирует является ли объект приводимым к json-строке согласно схеме АТОЛ Онлайн
+     *
      * @param Entity $entity
-     * @return $this
+     * @param array $json_structure
+     * @covers \AtolOnline\Entities\Entity::jsonSerialize
+     * @covers \AtolOnline\Entities\Entity::__toString
      */
-    public function checkAtolEntity(Entity $entity)
+    public function assertAtolable(Entity $entity, array $json_structure = []): void
     {
+        $this->assertIsObject($entity);
+        $this->assertIsObject($entity->jsonSerialize());
+        $this->assertIsString((string)$entity);
         $this->assertJson((string)$entity);
-        return $this;
-    }
-    
-    /**
-     *
-     */
-    public function tearDown(): void
-    {
-        //parent::tearDown();
-    }
-    
-    /**
-     * Возвращает случайную строку указанной длины
-     *
-     * @param int $length
-     * @return string
-     */
-    protected static function randomString($length = 8)
-    {
-        $characters = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
-        $string = '';
-        for ($i = 0; $i < $length; $i++) {
-            $string .= $characters[mt_rand(0, strlen($characters) - 1)];
+        if ($json_structure) {
+            $this->assertEquals(json_encode($json_structure), (string)$entity);
         }
-        return $string;
+    }
+
+    /**
+     * Провайдер валидных телефонов
+     *
+     * @return array<array<string, string>>
+     */
+    public function providerValidPhones(): array
+    {
+        return [
+            ['+79991234567', '+79991234567'],
+            ['79991234567', '+79991234567'],
+            ['89991234567', '+89991234567'],
+            ['+7 999 123 45 67', '+79991234567'],
+            ['+7 (999) 123-45-67', '+79991234567'],
+            ["+7 %(?9:9\"9')abc\r123\n45\t67\0", '+79991234567'],
+        ];
+    }
+
+    /**
+     * Провайдер валидных email-ов
+     *
+     * @return array<array<string>>
+     */
+    public function providerValidEmails(): array
+    {
+        return [
+            ['abc@mail.com'],
+            ['abc-d@mail.com'],
+            ['abc.def@mail.com'],
+            ['abc.def@mail.org'],
+            ['abc.def@mail-archive.com'],
+        ];
     }
 }