20250224

[Д] [StringExtension::Replace] Функция заменяет все вхождения строки поиска на строку замены в заданной строке (аналог mb_str_replace).

[Д] [StringExtension::ReplaceAll] Функция заменяет все вхождения строк поиск на соответствующие строки замены в заданной строке.

sources/classes/ClassMapper.php

@@ -4,12 +4,10 @@ namespace goodboyalex\php_components_pack\classes;
 
 use DateTimeImmutable;
 use DateTimeInterface;
-use Error;
 use Exception;
 use ReflectionClass;
 use ReflectionException;
 use stdClass;
-use Throwable;
 use UnitEnum;
 
 /**
@@ -51,79 +49,21 @@ final class ClassMapper
                     // ---- то исключаю его из массива разрешенных
                     unset($options['allowed'][array_search($ignoredProperty, $options['allowed'])]);
 
-        // Задаю массив свойств
+        // Получаю массив свойств
-        $properties = [];
+        $properties = get_class_vars(get_class($from));
-
-        // Получаю имя исходного класса
-        $className = get_class($from);
-
-        // Получение всех свойств класса
-        try {
-            $reflection = new ReflectionClass($className);
-        }
-        catch (ReflectionException) {
-            return;
-        }
-
-        // Получение всех свойств класса
-        $props = $reflection->getProperties();
-
-        // Создаю экземпляр класса
-        $instance = new $className();
-
-        // Для каждого свойства
-        foreach ($props as $prop) {
-            // - получаю имя свойства
-            $propName = $prop->getName();
-            // - получаю значение свойства
-            $value = $from->$propName;
-
-            try {
-                // - получаю тип свойства
-                $typeOf = gettype($from->$propName);
-
-                // - получаю значение свойства по типу и по умолчанию
-                $writeValue = self::GetDefaults($typeOf);
-
-                try {
-                    // - проверяем, можно ли записать и прочитать значение
-                    // -- пытаюсь установить значение
-                    $instance->$propName = $writeValue;
-                    // -- пытаюсь прочитать установленное значение
-                    $readValue = $instance->$propName;
-
-                    // -- и проверяю, что значение совпадают
-                    /** @noinspection PhpConditionAlreadyCheckedInspection */
-                    if ($readValue !== $writeValue)
-                        continue;
-                }
-                catch (Throwable) {
-                    // - в случае ошибки, понимаем, что свойство доступно или только для чтения, или
-                    // только для записи и оно нам не подходит. Поэтому пропускаем его.
-                    continue;
-                }
-
-                // - если свойство игнорируется
-                if (in_array($propName, $options['ignored']))
-                    // -- пропускаю
-                    continue;
-
-                // - если свойство не разрешено
-                if (count($options['allowed']) > 0 && !in_array($propName, $options['allowed']))
-                    // -- пропускаю
-                    continue;
-
-                // Если не было ошибки, значит свойство имеет и геттер, и сеттер
-                $properties[$propName] = $value;
-            }
-            catch (Error) {
-                // - в случае ошибки, понимаем, что свойство нам не подходит. Поэтому пропускаю его.
-                continue;
-            }
-        }
 
         // Для каждого элемента массива
         foreach ($properties as $name => $value) {
+            // - если свойство игнорируется
+            if (in_array($name, $options['ignored']))
+                // -- пропускаю
+                continue;
+
+            // - если свойство не разрешено
+            if (count($options['allowed']) > 0 && !in_array($name, $options['allowed']))
+                // -- пропускаю
+                continue;
+
             // - если свойство есть в объекте
             if (property_exists($to, $name))
                 // -- то присваиваю значение
@@ -131,26 +71,6 @@ final class ClassMapper
         }
     }
 
-    /**
-     * Возвращает значение по умолчанию для типа $typeName.
-     *
-     * @param string $typeName Тип
-     *
-     * @return mixed Значение по умолчанию
-     */
-    public static function GetDefaults (string $typeName): mixed
-    {
-        return match (strtolower($typeName)) {
-            'int', 'integer' => 0,
-            'float', 'double' => 0.0,
-            'bool', 'boolean' => false,
-            'string' => '',
-            'array' => [],
-            'object' => new stdClass(),
-            default => null,
-        };
-    }
-
     /**
      * Подготавливает значения свойств класса.
      *
@@ -160,8 +80,7 @@ final class ClassMapper
      *
      * @return array Массив данных класса.
      */
-    public
+    public static function PrepareClassProperties (array $params, ReflectionClass $classReflector,
-    static function PrepareClassProperties (array $params, ReflectionClass $classReflector,
         array $options = self::DefaultOptions): array
     {
         // Создаю массив данных класса
@@ -221,8 +140,7 @@ final class ClassMapper
      *
      * @return void
      */
-    public
+    public static function GetClassParametersArrayParser (array &$source, array $parametersKeys, mixed $value,
-    static function GetClassParametersArrayParser (array &$source, array $parametersKeys, mixed $value,
         array $options = self::DefaultOptions): void
     {
         // Если массив имен свойств пустой
@@ -271,8 +189,7 @@ final class ClassMapper
      * @return mixed Объект класса
      * @throws Exception
      */
-    public
+    public static function MapToClassProperty (string $className, array $properties): mixed
-    static function MapToClassProperty (string $className, array $properties): mixed
     {
         // Создаю
         try {
@@ -294,6 +211,15 @@ final class ClassMapper
                 // -- тип свойства
                 $propertyType = $property->getType();
 
+                // - если значение является типом bool
+                if ($propertyType->getName() === 'bool') {
+                    // -- присваиваю дату
+                    self::SetParameterToClass($classReflector, $key, $classObj, $value == "1");
+
+                    // -- следующий элемент
+                    continue;
+                }
+
                 // - если значение является классом
                 if (!$propertyType->isBuiltin() && is_array($value)) {
                     // -- присваиваю объект
@@ -368,8 +294,7 @@ final class ClassMapper
      *
      * @throws Exception
      */
-    public
+    public static function SetParameterToClass (ReflectionClass $classReflector, string $propertyName,
-    static function SetParameterToClass (ReflectionClass $classReflector, string $propertyName,
         mixed $classObj, mixed $value): void
     {
         try {
@@ -384,7 +309,7 @@ final class ClassMapper
             $property->setAccessible(true);
 
             // Если значение null
-            if ($value == null || $value == "null")
+            if (!is_bool($value) && ($value == null || $value == "null"))
                 // - то присваиваю значение по умолчанию
                 $value = self::GetDefaults($property->getType()->getName());
 
@@ -396,4 +321,24 @@ final class ClassMapper
             throw new Exception($exception->getMessage());
         }
     }
+
+    /**
+     * Возвращает значение по умолчанию для типа $typeName.
+     *
+     * @param string $typeName Тип
+     *
+     * @return mixed Значение по умолчанию
+     */
+    public static function GetDefaults (string $typeName): mixed
+    {
+        return match (strtolower($typeName)) {
+            'int', 'integer' => 0,
+            'float', 'double' => 0.0,
+            'bool', 'boolean' => false,
+            'string' => '',
+            'array' => [],
+            'object' => new stdClass(),
+            default => null,
+        };
+    }
 }

sources/extensions/StringExtension.php

@@ -207,4 +207,63 @@ final class StringExtension
         // Возвращаю обрезанный текст
         return mb_substr($text, 0, $lengthWithoutEndDots) . $endDots;
     }
+
+    /**
+     * Функция заменяет все вхождения строк поиск на соответствующие строки замены в заданной строке.
+     *
+     * @param array $searchReplace Массив с парами поиска и замены. Например, <code>['-' => '#', '$' => '%']</code>
+     *     заменит все дефисы на # и все доллары на %.
+     * @param string $subject Строка, в которой нужно выполнить замену.
+     * @param string $encoding (необязательный) Кодировка (по умолчанию, UTF-8).
+     *
+     * @return string Возвращает новую строку с выполненными заменами.
+     */
+    public static function ReplaceAll (array $searchReplace, string $subject, string $encoding = 'UTF-8'): string
+    {
+        // Создаю результат
+        $result = $subject;
+
+        // Для каждой пары поиска и замены
+        foreach ($searchReplace as $search => $replace)
+            // - заменяю все вхождения строки поиска на строку замены в заданной строке
+            $result = self::Replace($search, $replace, $result, $encoding);
+
+        // Возвращаю результат
+        return $result;
+    }
+
+    /**
+     * Функция заменяет все вхождения строки поиска на строку замены в заданной строке (аналог mb_str_replace).
+     *
+     * @param string $search Строка, которую нужно найти и заменить.
+     * @param string $replace Строка, на которую нужно заменить найденную строку.
+     * @param string $subject Строка, в которой нужно выполнить замену.
+     * @param string $encoding (необязательный) Кодировка (по умолчанию, UTF-8).
+     *
+     * @return string Возвращает новую строку с выполненной заменой.
+     */
+    public static function Replace (string $search, string $replace, string $subject,
+        string $encoding = 'UTF-8'): string
+    {
+        // Если кодировка не UTF-8
+        if ($encoding != 'UTF-8') {
+            // - то перекодируем строку поиска, замены и исходную строку в UTF-8
+            $search = mb_convert_encoding($search, 'UTF-8', $encoding);
+            // - и перекодируем строку замены в UTF-8
+            $replace = mb_convert_encoding($replace, 'UTF-8', $encoding);
+            // - и перекодируем исходную строку в UTF-8
+            $subject = mb_convert_encoding($subject, 'UTF-8', $encoding);
+        }
+
+        // С помощью регулярного выражения заменяем все вхождения строки поиска на строку замены
+        $result = preg_replace('/' . preg_quote($search, '/') . '/u', $replace, $subject);
+
+        // Если кодировка не UTF-8
+        if ($encoding != 'UTF-8')
+            // - то перекодируем результат в исходную кодировку
+            $result = mb_convert_encoding($result, $encoding, 'UTF-8');
+
+        // Возвращаем результат
+        return $result;
+    }
 }

tests/extensions/StringExtensionTest.php

@@ -63,4 +63,20 @@ class StringExtensionTest extends TestCase
         $this->assertEquals('', StringExtension::GetShortText('test', 0));
 
     }
-}
+
+    public function testReplace ()
+    {
+        $this->PrepareForTest();
+
+        $this->assertEquals('Все 2 ночи и 2 дня 2 друга искали тебя!',
+            StringExtension::Replace("4", "2", "Все 4 ночи и 4 дня 2 друга искали тебя!"));
+    }
+
+    public function testReplaceAll ()
+    {
+        $this->PrepareForTest();
+
+        $this->assertEquals('Все 5 ночи и 5 дня 2 друга искали тебя!',
+            StringExtension::ReplaceAll(["4" => "5", "3" => "2"], "Все 4 ночи и 4 дня 3 друга искали тебя!"));
+    }
+}