From f3db4e8041962618a7e99385388dee8f14be846b Mon Sep 17 00:00:00 2001
From: babaev-an <babaev-an@babaev-an.ru>
Date: Mon, 28 Jul 2025 16:51:22 +0300
Subject: [PATCH] 20250728 1.2.2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

[-] Удалён интерфейс IStoredAtSQL (перемещён в пакет php_db_components_pack.

[+] Добавлен класс шифрования Encryptor.
---
 composer.json                       |  3 +-
 sources/classes/Encryptor.php       | 60 +++++++++++++++++++++++++++++
 sources/interfaces/IStoredAtSQL.php | 32 ---------------
 3 files changed, 62 insertions(+), 33 deletions(-)
 create mode 100644 sources/classes/Encryptor.php
 delete mode 100644 sources/interfaces/IStoredAtSQL.php

diff --git a/composer.json b/composer.json
index 49584ef..c4e26c1 100644
--- a/composer.json
+++ b/composer.json
@@ -17,7 +17,8 @@
   ],
   "require": {
     "php": "^8.4",
-    "ext-mbstring": "*"
+    "ext-mbstring": "*",
+    "ext-openssl": "*"
   },
   "require-dev": {
     "phpunit/phpunit": "^12.2.7"
diff --git a/sources/classes/Encryptor.php b/sources/classes/Encryptor.php
new file mode 100644
index 0000000..bdc9107
--- /dev/null
+++ b/sources/classes/Encryptor.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace goodboyalex\php_components_pack\classes;
+
+/**
+ * Класс криптографической защиты.
+ *
+ * @author Александр Бабаев
+ * @package php_components_pack
+ * @version 1.0
+ * @since 1.2.2
+ */
+final class Encryptor
+{
+    /**
+     * Шифрует данные.
+     *
+     * @param string $string Данные для шифрования.
+     * @param string $key Ключ шифрования.
+     *
+     * @return string|false Шифрованные данные или false в случае ошибки.
+     */
+    public static function Encrypt (string $string, string $key): string|false
+    {
+        // Метод шифрования
+        $cipher = 'aes-256-cbc';
+
+        // Длинна ненулевого вектора инициализации
+        $ivLen = openssl_cipher_iv_length($cipher);
+
+        // Ненулевой вектор инициализации
+        $iv = openssl_random_pseudo_bytes($ivLen);
+
+        // Шифрую и вывожу
+        return openssl_encrypt($string, $cipher, $key, iv: $iv) . ":" . base64_encode($iv);
+    }
+
+    /**
+     * Дешифрует данные.
+     *
+     * @param string $string Данные для дешифрования.
+     * @param string $key Ключ шифрования.
+     *
+     * @return string|false Дешифрованные данные или false в случае ошибки.
+     */
+    public static function Decrypt (string $string, string $key): false|string
+    {
+        // Метод шифрования
+        $cipher = 'aes-256-cbc';
+
+        // Разделённый массив с шифрованными данными и вектором инициализации
+        $cryptArray = explode(':', $string);
+
+        // Ненулевой вектор инициализации
+        $iv = base64_decode($cryptArray[1]);
+
+        // Дешифрую и вывожу
+        return openssl_decrypt($cryptArray[0], $cipher, $key, iv: $iv);
+    }
+}
\ No newline at end of file
diff --git a/sources/interfaces/IStoredAtSQL.php b/sources/interfaces/IStoredAtSQL.php
deleted file mode 100644
index 2408850..0000000
--- a/sources/interfaces/IStoredAtSQL.php
+++ /dev/null
@@ -1,32 +0,0 @@
-<?php
-
-namespace goodboyalex\php_components_pack\interfaces;
-
-/**
- * Интерфейс поддержки моделей и классов, реализующих хранение свойств в SQL базе данных.
- *
- * @author Александр Бабаев
- * @package freecms
- * @version 0.1
- * @since 0.1
- */
-interface IStoredAtSQL
-{
-    /**
-     * Вывод параметров добавления/обновления данных в базу данных.
-     *
-     * @param bool $withId Нужно ли добавлять Id в массив
-     *
-     * @return array Массив параметров
-     */
-    public function ToSQL (bool $withId = true): array;
-
-    /**
-     * Преобразование данных из базы данных в модель, класс.
-     *
-     * @param array $sqlData Данные из базы данных
-     *
-     * @return self Класс модели с заполненными данными из базы данных
-     */
-    public function FromSQL (array $sqlData): self;
-}
\ No newline at end of file