From 91b3aa1f2598148172b0e12cf02ff0314244baa0 Mon Sep 17 00:00:00 2001
From: Artem Vasilev <kern.usr@gmail.com>
Date: Wed, 9 Nov 2022 22:20:31 +0300
Subject: [PATCH] =?UTF-8?q?=D0=BF=D0=BE=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D0=BB=20phpdoc?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/CryptoPro.php | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/src/CryptoPro.php b/src/CryptoPro.php
index 295af62..438ca62 100755
--- a/src/CryptoPro.php
+++ b/src/CryptoPro.php
@@ -24,7 +24,7 @@ class CryptoPro
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
 	 * @throws \Exception
-	 * @return void
+	 * @return Certificate[]
 	 */
 	public static function getUserCertificates(bool $resetCache = false)
 	{
@@ -44,7 +44,7 @@ class CryptoPro
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
 	 * @throws \Exception
-	 * @return void
+	 * @return Certificate[]
 	 */
 	public static function getAllUserCertificates(bool $resetCache = false)
 	{
@@ -68,7 +68,7 @@ class CryptoPro
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
 	 * @throws \Exception
-	 * @return void
+	 * @return Certificate[]
 	 */
 	public static function getContainerCertificates(bool $resetCache = false)
 	{
@@ -88,7 +88,7 @@ class CryptoPro
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
 	 * @throws \Exception
-	 * @return void
+	 * @return Certificate[]
 	 */
 	public static function getAllContainerCertificates(bool $resetCache = false)
 	{
@@ -111,7 +111,7 @@ class CryptoPro
 	 *
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
-	 * @return array
+	 * @return Certificate[]
 	 */
 	public static function getCertificates(bool $resetCache = false)
 	{
@@ -153,7 +153,7 @@ class CryptoPro
 	 *
 	 * @param   bool  $resetCache  Сбросить кэш. true - повторно получить список сертификатов из хранилища
 	 *
-	 * @return array
+	 * @return Certificate[]
 	 */
 	public static function getAllCertificates(bool $resetCache = false)
 	{
@@ -608,7 +608,7 @@ class CryptoPro
 
 		try
 		{
-			$cadesHashedData->set_Algorithm(CADESCOM_HASH_ALGORITHM_CP_GOST_3411_2012_256);
+			$cadesHashedData->set_Algorithm(CADESCOM_HASH_ALGORITHM::HASH_CP_GOST_3411_2012_256);
 			$cadesHashedData->set_DataEncoding(BASE64_TO_BINARY);
 			$cadesHashedData->Hash($messageBase64);
 		}
@@ -748,6 +748,14 @@ class CryptoPro
 		return $certificates;
 	}
 
+	/**
+	 * @param   string  $thumbprint
+	 * @param   int     $storeLocation
+	 * @param   string  $storeName
+	 *
+	 * @throws \Exception
+	 * @return \CPCertificate
+	 */
 	protected static function getCadesCertificateFromStore(string $thumbprint, int $storeLocation, string $storeName = 'My')
 	{
 		$thumbprint = mb_strtoupper($thumbprint);