mirror of
				https://github.com/crypto-pro-web/crypto-pro-php-stubs.git
				synced 2025-10-31 01:13:22 +03:00 
			
		
		
		
	Описание класса хэш-значение данных
This commit is contained in:
		
							parent
							
								
									c88fb1198e
								
							
						
					
					
						commit
						2e51517b43
					
				| @ -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() | ||||
| 	{ | ||||
| 	} | ||||
| 
 | ||||
| } | ||||
|  | ||||
		Loading…
	
		Reference in New Issue
	
	Block a user