From 71958482c5e413547c8b1ef762e36904370f3e3b Mon Sep 17 00:00:00 2001
From: babaev-an <babaev-an@babaev-an.ru>
Date: Mon, 26 May 2025 13:28:46 +0300
Subject: [PATCH] 20250526
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Добавлен класс File, который реализует функционал работы с файлами и выполнение операций над файлами одной командой.
---
 composer.lock              |   4 +-
 sources/classes/File.php   | 148 +++++++++++++++++++++++++++++++++++++
 tests/classes/FileTest.php |  62 ++++++++++++++++
 3 files changed, 212 insertions(+), 2 deletions(-)
 create mode 100644 sources/classes/File.php
 create mode 100644 tests/classes/FileTest.php

diff --git a/composer.lock b/composer.lock
index 507a853..df8a959 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-  "content-hash": "0c5a35b9c8987ac3fd0f7480fea87d4c",
+    "content-hash": "0c5a35b9c8987ac3fd0f7480fea87d4c",
     "packages": [],
     "packages-dev": [
         {
@@ -1621,4 +1621,4 @@
     },
     "platform-dev": {},
     "plugin-api-version": "2.6.0"
-}
\ No newline at end of file
+}
diff --git a/sources/classes/File.php b/sources/classes/File.php
new file mode 100644
index 0000000..6264a2d
--- /dev/null
+++ b/sources/classes/File.php
@@ -0,0 +1,148 @@
+<?php
+
+namespace goodboyalex\php_components_pack\classes;
+
+/**
+ * Класс, реализующий функционал работы с файлами и выполнение операций над файлами одной командой.
+ *
+ * @author Александр Бабаев
+ * @package php_components_pack
+ * @version 1.2
+ * @since 1.0.20
+ */
+final class File
+{
+    /**
+     * Получает список файлов в директории и поддиректориях, соответствующей шаблону $pattern.
+     *
+     * @param string $dir Родительская директория
+     * @param string $pattern Шаблон имени файла
+     *
+     * @return false|array Список файлов или false в случае ошибки
+     */
+    public static function FindFiles (string $dir, string $pattern = '*.php'): false|array
+    {
+        // Получаем список файлов и каталогов в текущей директории
+        $files = glob("$dir/$pattern");
+
+        // Если произошла ошибка
+        if ($files === false)
+            // - то возвращаем false
+            return false;
+
+        // Перебираем поддиректории
+        foreach (glob("$dir/*", GLOB_ONLYDIR | GLOB_NOSORT) as $subDir) {
+            // - если ошибка
+            if ($subDir === false)
+                // - то пропускаем
+                continue;
+
+            // - рекурсивный вызов для каждой поддиректории
+            $files = array_merge($files, self::FindFiles($subDir, $pattern));
+        }
+
+        // Возвращаем список файлов
+        return $files;
+    }
+
+    /**
+     * Получает имя файла без пути к нему и расширения.
+     *
+     * @param string $fileName Полное имя файла с путем к нему.
+     *
+     * @return string Имя файла без пути к нему и расширения.
+     */
+    public static function ExtractFileNameWithoutExtension (string $fileName): string
+    {
+        // Имя файла без пути к нему
+        $fileNameOnly = self::ExtractFileName($fileName);
+
+        // Расширение файла
+        $fileExtension = self::ExtractFileExtension($fileName);
+
+        // Возвращаем имя файла без пути к нему и расширения.
+        return substr($fileNameOnly, 0, -strlen($fileExtension) - 1);
+    }
+
+    /**
+     * Получает имя файла без пути к нему, но с расширением.
+     *
+     * @param string $fileName Полное имя файла с путем к нему.
+     *
+     * @return string Имя файла без пути к нему, но с расширением.
+     */
+    public static function ExtractFileName (string $fileName): string
+    {
+        return basename($fileName);
+    }
+
+    /**
+     * Получает расширение файла.
+     *
+     * @param string $fileName Имя файла с путем к нему.
+     *
+     * @return string Расширение файла.
+     */
+    public static function ExtractFileExtension (string $fileName): string
+    {
+
+        return pathinfo($fileName, PATHINFO_EXTENSION);
+    }
+
+    /**
+     * Получает относительный путь к файлу, относительно заданной папки
+     *
+     * @param string $fullPath Полный путь к файлу
+     * @param string $basePath Вырезаемый путь (с начала)
+     *
+     * @return false|string Относительный путь к файлу
+     */
+    public static function GetRelativePath (string $fullPath, string $basePath): false|string
+    {
+        return stripos($fullPath, $basePath) !== false ? str_replace($basePath, "", $fullPath) : false;
+    }
+
+    /**
+     * Удаляет директорию вместе со всеми файлами и поддиректориями.
+     *
+     * @param string $directory Полный путь к директории.
+     *
+     * @return bool Результат удаления.
+     */
+    public static function RemoveDir (string $directory): bool
+    {
+        // Если директории не существует
+        if (!file_exists($directory))
+            // - то удаление не требуется
+            return true;
+
+        // Если это не директория
+        if (!is_dir($directory))
+            // - то удаляем файл
+            return unlink($directory);
+
+        // Перебираем все файлы и поддиректории
+        foreach (scandir($directory) as $item) {
+            // - если это '.' или '..'
+            if ($item == '.' || $item == '..')
+                // -- то пропускаем
+                continue;
+
+            // - задаём переменную - целевую директорию
+            $target = $directory . DIRECTORY_SEPARATOR . $item;
+
+            // - если это директория
+            if (is_dir($target))
+                // -- то рекурсивно удаляем её
+                if (!self::RemoveDir($target))
+                    // --- и прерываем удаление директории, если ошибка
+                    return false;
+                else
+                    // -- иначе удаляем файл
+                    unlink($target);
+        }
+
+        // Удаляем директорию
+        return rmdir($directory);
+    }
+}
\ No newline at end of file
diff --git a/tests/classes/FileTest.php b/tests/classes/FileTest.php
new file mode 100644
index 0000000..2bbe3d2
--- /dev/null
+++ b/tests/classes/FileTest.php
@@ -0,0 +1,62 @@
+<?php
+
+namespace goodboyalex\php_components_pack\tests\classes;
+
+use goodboyalex\php_components_pack\classes\File;
+use PHPUnit\Framework\TestCase;
+
+class FileTest extends TestCase
+{
+    public function testExtractFileName ()
+    {
+        $this->PrepareForTest();
+
+        $this->assertEquals("test.txt", File::ExtractFileName("c:\\tmp\\test.txt"));
+        $this->assertEquals("test.txt", File::ExtractFileName("c:/tmp/test.txt"));
+        $this->assertEquals("test.txt", File::ExtractFileName("\\tmp\\test.txt"));
+    }
+
+    private function PrepareForTest (): void
+    {
+        require_once __DIR__ . '/../../sources/classes/File.php';
+    }
+
+    public function testFindFiles ()
+    {
+        $this->PrepareForTest();
+
+        $result = File::FindFiles(__DIR__);
+
+        $this->assertIsArray($result);
+        $this->assertCount(8, $result);
+    }
+
+    public function testGetRelativePath ()
+    {
+        $this->PrepareForTest();
+
+        $fullPath = "c:\\source\\tmp\\test.txt";
+
+        $basePath = "c:\\source\\";
+
+        $this->assertEquals("tmp\\test.txt", File::GetRelativePath($fullPath, $basePath));
+    }
+
+    public function testExtractFileExtension ()
+    {
+        $this->PrepareForTest();
+
+        $this->assertEquals("txt", File::ExtractFileExtension("c:\\tmp\\test.txt"));
+        $this->assertEquals("txt", File::ExtractFileExtension("c:/tmp/test.txt"));
+        $this->assertEquals("txt", File::ExtractFileExtension("\\tmp\\test.txt"));
+    }
+
+    public function testExtractFileNameWithoutExtension ()
+    {
+        $this->PrepareForTest();
+
+        $this->assertEquals("test", File::ExtractFileNameWithoutExtension("c:\\tmp\\test.txt"));
+        $this->assertEquals("test", File::ExtractFileNameWithoutExtension("c:/tmp/test.txt"));
+        $this->assertEquals("test", File::ExtractFileNameWithoutExtension("\\tmp\\test.txt"));
+    }
+}