From 2e51517b439283a25211628743baf8e23f91e6f0 Mon Sep 17 00:00:00 2001
From: Artem Vasilev <kern.usr@gmail.com>
Date: Mon, 24 Oct 2022 17:52:33 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8?=
 =?UTF-8?q?=D0=B5=20=D0=BA=D0=BB=D0=B0=D1=81=D1=81=D0=B0=20=D1=85=D1=8D?=
 =?UTF-8?q?=D1=88-=D0=B7=D0=BD=D0=B0=D1=87=D0=B5=D0=BD=D0=B8=D0=B5=20?=
 =?UTF-8?q?=D0=B4=D0=B0=D0=BD=D0=BD=D1=8B=D1=85?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/CPHashedData.php | 222 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 201 insertions(+), 21 deletions(-)

diff --git a/src/CPHashedData.php b/src/CPHashedData.php
index f9f43d0..95c9053 100644
--- a/src/CPHashedData.php
+++ b/src/CPHashedData.php
@@ -1,26 +1,206 @@
 <?php
 
+/**
+ * Хэш-значение данных.
+ * Объект HashedData предоставляет интерфейсы ICPHashedData, ICPHashedData2 и интерфейс, аналогичный интерфейсу объекта CAPICOM.HashedData.
+ * В отличие от объекта CAPICOM.HashedData, объект HashedData поддерживает алгоритм хэширования ГОСТ Р 34.11-94 и ГОСТ Р 34.11-2012.
+ *
+ * @link https://docs.cryptopro.ru/cades/reference/cadescom/cadescom_interface/icphasheddata
+ * @link https://docs.cryptopro.ru/cades/reference/cadescom/cadescom_interface/icphasheddata2
+ * @link https://learn.microsoft.com/windows/win32/seccrypto/hasheddata
+ *
+ * @param-read $Algorithm
+ * @param-read $Value
+ * @param-read $DataEncoding
+ * @param-read $Key
+ */
 class CPHashedData
 {
-	
-	public function __construct(){}
-	
-	public function Hash(){}
-	
-	public function SetHashValue(){}
-	
-	public function get_Value(){}
-	
-	public function set_Key(){}
-	
-	public function get_Key(){}
-	
-	public function set_Algorithm(){}
-	
-	public function get_Algorithm(){}
-	
-	public function set_DataEncoding(){}
-	
-	public function get_DataEncoding(){}
-	
+
+	/**
+	 *
+	 */
+	public function __construct()
+	{
+	}
+
+	/**
+	 * Вычисляет хэш для заданной строки.
+	 *
+	 * @param   string  $newVal  Строка, содержащая значение для хеширования.
+	 *
+	 * @return void
+	 */
+	public function Hash(string $newVal)
+	{
+	}
+
+	/**
+	 * Позволяет проинициализировать объект готовым хэш-значением.
+	 *
+	 * @param   string  $newVal  Хэш-значение, которым следует проинициализировать объект. Должно быть представлено в виде строки шестнадцатеричных цифр.
+	 *
+	 * @return void
+	 */
+	public function SetHashValue(string $newVal)
+	{
+	}
+
+	/**
+	 * Возвращает результат операции хэширования
+	 *
+	 * @return string
+	 */
+	public function get_Value()
+	{
+	}
+
+	/**
+	 * Устанавливает данные для установки ключа, используемого для вычисления HMAC
+	 *
+	 * @return void
+	 */
+	public function set_Key(string $Key)
+	{
+	}
+
+	/**
+	 * Возвращает данные для установки ключа, используемого для вычисления HMAC
+	 *
+	 * @return string
+	 */
+	public function get_Key()
+	{
+	}
+
+	/**
+	 * Задает алгоритм хэширования.
+	 *
+	 * @param   mixed  $Algorithm         Алгоритм хэширования. По умолчанию ENCODE_BASE64.
+	 *                                    Может принимать следующие значения:
+	 *                                    <table>
+	 *                                    <thead>
+	 *                                    <tr>
+	 *                                    <th>Значение</th>
+	 *                                    <th>Описание</th>
+	 *                                    </tr>
+	 *                                    </thead>
+	 *                                    <tbody>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_SHA1</strong></td>
+	 *                                    <td>Алгоритм хэширования SHA1.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_MD2</strong></td>
+	 *                                    <td>Алгоритм хэширования MD2.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_MD4</strong></td>
+	 *                                    <td>Алгоритм хэширования MD4.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_MD5</strong></td>
+	 *                                    <td>Алгоритм хэширования MD5.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_SHA_256</strong></td>
+	 *                                    <td>Хэш-алгоритм SHA-256.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_SHA_384</strong></td>
+	 *                                    <td>Хэш-алгоритм SHA-384.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_SHA_512</strong></td>
+	 *                                    <td>Хэш-алгоритм SHA-512.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>HASH_ALGORITHM_GOSTR_3411</strong></td>
+	 *                                    <td>Хэш-алгоритм ГОСТ 34.11 - 94.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411</strong></td>
+	 *                                    <td>Хэш-алгоритм ГОСТ 34.11 - 94.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411_2012_256</strong></td>
+	 *                                    <td>Хэш-алгоритм ГОСТ 34.11 - 2012 c длиной ключа 256 бит.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411_2012_512</strong></td>
+	 *                                    <td>Хэш-алгоритм ГОСТ 34.11 - 2012 c длиной ключа 512 бит.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411_HMAC</strong></td>
+	 *                                    <td>Хэш-алгоритм HMAC ГОСТ 34.11 - 94.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411_2012_256_HMAC</strong></td>
+	 *                                    <td>Хэш-алгоритм HMAC ГОСТ 34.11 - 2012 c длиной ключа 256 бит.</td>
+	 *                                    </tr>
+	 *                                    <tr>
+	 *                                    <td><strong>CADESCOM_HASH_ALGORITHM_CP_GOST_3411_2012_512_HMAC</strong></td>
+	 *                                    <td>Хэш-алгоритм HMAC ГОСТ 34.11 - 2012 c длиной ключа 512 бит.</td>
+	 *                                    </tr>
+	 *                                    </tbody>
+	 *                                    </table>
+	 *
+	 * @return void
+	 */
+	public function set_Algorithm($Algorithm = HASH_ALGORITHM_SHA1)
+	{
+	}
+
+	/**
+	 * Возвращает алгоритм хэширования.
+	 *
+	 * @return mixed
+	 */
+	public function get_Algorithm()
+	{
+	}
+
+	/**
+	 * Задает способ кодирования данных для хэширования
+	 *
+	 * @param   mixed  $DataEncoding            кодировка данных, передаваемых в метод Hash()
+	 *                                          Может принимать следующие значения:
+	 *                                          <table>
+	 *                                          <thead>
+	 *                                          <tr>
+	 *                                          <th>Имя</th>
+	 *                                          <th>Описание</th>
+	 *                                          <th>Значение</th>
+	 *                                          </tr>
+	 *                                          </thead>
+	 *                                          <tbody>
+	 *                                          <tr>
+	 *                                          <td><strong>STRING_TO_UCS2LE</strong></td>
+	 *                                          <td>Кодировка UTF-8 или UNICODE.<br></td>
+	 *                                          <td>0</td>
+	 *                                          </tr>
+	 *                                          <tr>
+	 *                                          <td><strong>BASE64_TO_BINARY</strong></td>
+	 *                                          <td>Кодировка BASE64.</td>
+	 *                                          <td>1</td>
+	 *                                          </tr>
+	 *                                          </tbody>
+	 *                                          </table>
+	 *
+	 *
+	 * @return void
+	 */
+	public function set_DataEncoding($DataEncoding = STRING_TO_UCS2LE)
+	{
+	}
+
+	/**
+	 * Возвращает способ кодирования данных для хэширования
+	 *
+	 * @return mixed
+	 */
+	public function get_DataEncoding()
+	{
+	}
+
 }