20250223

[О] [ClassMapper::MapClass]: Отменена проверка свойства на доступность get и set, так как выдавала ошибку. Используйте лучше в таких случаях $options['ignored'] для таких свойств.

composer.json

@@ -16,11 +16,11 @@
     }
   ],
   "require": {
-    "php": ">=8.4",
+    "php": "^8.4",
     "ext-mbstring": "*"
   },
   "require-dev": {
-    "phpunit/phpunit": ">=11.5.6"
+    "phpunit/phpunit": "^12.0.4"
   },
   "autoload": {
     "psr-4": {

sources/classes/ClassMapper.php

@@ -314,18 +314,18 @@ final class ClassMapper
     }
 
     /**
-     * Получает значение по умолчанию для разных типов данных.
+     * Возвращает значение по умолчанию для типа $typeName.
      *
-     * @param string $typeName Имя типа данных.
+     * @param string $typeName Тип
      *
-     * @return mixed|null Результат.
+     * @return mixed Значение по умолчанию
      */
     public static function GetDefaults (string $typeName): mixed
     {
-        return match ($typeName) {
-            'int' => 0,
-            'float' => 0.0,
-            'bool' => false,
+        return match (strtolower($typeName)) {
+            'int', 'integer' => 0,
+            'float', 'double' => 0.0,
+            'bool', 'boolean' => false,
             'string' => '',
             'array' => [],
             'object' => new stdClass(),

sources/extensions/BoolExtensions.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace goodboyalex\php_components_pack\extensions;
+
+use Exception;
+
+/**
+ * Расширение типа "правда/ложь".
+ *
+ * @author Александр Бабаев
+ * @package php_components_pack
+ * @version 1.0
+ * @since 1.0.7
+ */
+final class BoolExtensions
+{
+    /**
+     * Вывод в строку <code>ifTrue</code>, если выражение <code>b</code> правдиво и <code>ifFalse</code> в противном
+     * случае.
+     *
+     * @param bool $b Выражение типа правда/ложь.
+     * @param string $ifTrue Строка для правдивого выражения. По умолчанию "true".
+     * @param string $ifFalse Строка для лживого выражения. По умолчанию "false".
+     *
+     * @return string Вывод строки.
+     */
+    public static function ExportToString (bool $b, string $ifTrue = "true", string $ifFalse = "false"): string
+    {
+        return $b ? $ifTrue : $ifFalse;
+    }
+
+    /**
+     * Вычисляет, есть ли хотя бы одно из переменных формата правда/ложь <code>expressions</code> в значении
+     * <code>true</code>.
+     *
+     * @param array $expressions Переменные формата правда/ложь.
+     *
+     * @return bool Есть ли хотя бы одно в значении true.
+     *
+     * @throws Exception Выбрасывается, если хотя бы один аргумент <code>expressions</code> не являются типом
+     *     правда/ложь.
+     */
+    public static function AnyTrue (array $expressions): bool
+    {
+        return self::TrueCount($expressions) > 0;
+    }
+
+    /**
+     * Вычисляет количество переменных формата правда/ложь <code>expressions</code> в значении <code>true</code>.
+     *
+     * @param array $expressions Переменные формата правда/ложь.
+     *
+     * @return int Количество переменных в значении true.
+     *
+     * @throws Exception Выбрасывается, если хотя бы один аргумент <code>expressions</code> не являются типом
+     *     правда/ложь.
+     */
+    public static function TrueCount (array $expressions): int
+    {
+        // Проверяем все аргументы
+        foreach ($expressions as $expression)
+            // - если аргумент не является типом правда/ложь
+            if (!is_bool($expression))
+                // -- то выбрасываем исключение
+                throw new Exception('All arguments must be bool. / Все аргументы должны быть типа «правда/ложь».');
+
+        // Используем array_filter для фильтрации всех истинных значений
+        $filtered = array_filter($expressions);
+
+        // Возвращаем количество элементов в отфильтрованном массиве
+        return count($filtered);
+    }
+}

tests/classes/ClassMapperTest.php

@@ -3,6 +3,8 @@
 namespace goodboyalex\php_components_pack\tests\classes;
 
 use goodboyalex\php_components_pack\classes\ClassMapper;
+use goodboyalex\php_components_pack\tests\data\A;
+use goodboyalex\php_components_pack\tests\data\B;
 use PHPUnit\Framework\TestCase;
 
 class ClassMapperTest extends TestCase
@@ -11,12 +13,10 @@ class ClassMapperTest extends TestCase
     {
         $this->PrepareForTest();
 
-        $a = new \goodboyalex\php_components_pack\tests\data\A();
-        $a->a = 'a';
-        $a->b = 2;
-        $a->c = true;
+        $a = new A('a', 2, true);
 
         $b = new B();
+
         ClassMapper::MapClass($a, $b);
 
         $this->assertEquals('a', $b->a);

tests/data/B.php

@@ -1,10 +1,17 @@
 <?php
 
-namespace goodboyalex\php_components_pack\tests\classes;
+namespace goodboyalex\php_components_pack\tests\data;
 
 class B
 {
     public string $a;
     public int $b;
     public string $d;
+
+    public function __construct (string $a = "", int $b = 0, string $d = "")
+    {
+        $this->a = $a;
+        $this->b = $b;
+        $this->d = $d;
+    }
 }

tests/extensions/BoolExtensionsTest.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace goodboyalex\php_components_pack\tests\extensions;
+
+use Exception;
+use goodboyalex\php_components_pack\extensions\BoolExtensions;
+use PHPUnit\Framework\TestCase;
+
+class BoolExtensionsTest extends TestCase
+{
+    public function testAnyTrue ()
+    {
+        $this->PrepareForTest();
+
+        $hasTrue = [
+            true, false, true, false, true, false, true, false, true, false, true, false, true, false, true, false,
+            true, false, true, false, true, false, true, false, true, false, true, false
+        ];
+
+        $noTrue = [
+            false, false, false, false, false, false, false, false, false, false, false, false, false, false, false,
+            false, false, false, false, false, false, false, false, false, false, false
+        ];
+
+        $this->assertTrue(BoolExtensions::AnyTrue($hasTrue));
+
+        $this->assertFalse(BoolExtensions::AnyTrue($noTrue));
+
+    }
+
+    private function PrepareForTest (): void
+    {
+        require_once __DIR__ . '/../../sources/extensions/BoolExtensions.php';
+    }
+
+    public function testTrueCount ()
+    {
+        $this->PrepareForTest();
+
+        $array = [
+            true, false, true, false, true, false, true, false, true, false, true, false,
+            true, false, true, false, true, false, true, false, true, false, true, false, true, false, true,
+            false
+        ];
+
+        $this->assertEquals(14,
+            BoolExtensions::TrueCount($array));
+
+        $this->expectException(Exception::class);
+
+        $array[] = "ПРЕДАТЕЛЬ!";
+
+        BoolExtensions::TrueCount($array);
+    }
+
+    public function testExportToString ()
+    {
+        $this->PrepareForTest();
+
+        $b = true;
+
+        $this->assertEquals('О, да!', BoolExtensions::ExportToString($b, 'О, да!', 'О, нет!'));
+
+        $b = false;
+
+        $this->assertEquals('О, нет!', BoolExtensions::ExportToString($b, 'О, да!', 'О, нет!'));
+    }
+}