diff --git a/src/CPCertificates.php b/src/CPCertificates.php index cc84e47..3150142 100644 --- a/src/CPCertificates.php +++ b/src/CPCertificates.php @@ -14,150 +14,201 @@ class CPCertificates /** * Возвращает коллекцию сертификатов, удовлетворяющих заданному критерию. * - * @param int $FindType Тип критериев сопоставления, предоставленных в параметре varCriteria. - * Может принимать следующие значения: - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
ЗначениеПояснение
- * CERTIFICATE_FIND_SHA1_HASH - * - * Returns certificates with a SHA1 hash that matches - * the SHA1 hash specified in the varCriteria parameter. - *
- * CERTIFICATE_FIND_SUBJECT_NAME - * - * Returns certificates whose subject name exactly - * or partially matches the subject name specified in the - * varCriteria parameter. This call searches the subject name field only. - *
- * CERTIFICATE_FIND_ISSUER_NAME - * - * Returns certificates whose issuer name exactly - * or partially matches the issuer name specified in the - * varCriteria parameter. This call searches the issuer name field only. - *
- * CERTIFICATE_FIND_ROOT_NAME - * - * Returns certificates whose root subject name exactly - * or partially matches the root subject name specified in - * the varCriteria parameter. This call creates a chain. - * This call searches the subject name field of the root certificate. - *
- * CERTIFICATE_FIND_TEMPLATE_NAME - * - * Returns certificates whose template name matches - * the template name specified in the varCriteria parameter. - *
- * CERTIFICATE_FIND_EXTENSION - * - * Returns certificates that have an extension - * that matches the extension specified in the - * varCriteria parameter. - *
- * CERTIFICATE_FIND_EXTENDED_PROPERTY - * - * Returns certificates in the store that explicitly - * contain an extended property with the value specified - * in the varCriteria parameter. - *
- * CERTIFICATE_FIND_APPLICATION_POLICY - * - * Returns certificates in the store that have - * either an enhanced key usage extension, application policy extension, - * or extended property specified in the varCriteria parameter. - *
- * CERTIFICATE_FIND_CERTIFICATE_POLICY - * - * Returns certificates that contain the policy OID - * in the Certificate Policy extension specified - * in the varCriteria parameter. - *
- * CERTIFICATE_FIND_TIME_VALID - * - * Returns certificates whose time is valid. - *
- * CERTIFICATE_FIND_TIME_NOT_YET_VALID - * - * Returns certificates whose time is not yet valid. - *
- * CERTIFICATE_FIND_TIME_EXPIRED - * - * Returns certificates whose time has expired. - *
- * CERTIFICATE_FIND_KEY_USAGE - * - * Returns certificates containing key usages in the - * KeyUsage extension specified in the varCriteria - * parameter. If the KeyUsage extension is not present, - * all of the key usages are assumed to be unavailable. - *
- * @param mixed $varCriteria (optional) Вариант, содержащий критерии поиска. - * Эти данные должны соответствовать типу данных, указанному в параметре FindType. - * @param bool $bFindValidOnly (optional) Логическое значение, указывающее, возвращаются ли только действительные сертификаты. + * @param int $FindType Тип критериев сопоставления, предоставленных в параметре varCriteria. + * Может принимать следующие значения: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
ЗначениеПояснение
+ * CERTIFICATE_FIND_SHA1_HASH + * + * Returns certificates with a SHA1 hash that matches + * the SHA1 hash specified in the varCriteria parameter. + *
+ * CERTIFICATE_FIND_SUBJECT_NAME + * + * Returns certificates whose subject name exactly + * or partially matches the subject name specified in the + * varCriteria parameter. This call searches the subject name field only. + *
+ * CERTIFICATE_FIND_ISSUER_NAME + * + * Returns certificates whose issuer name exactly + * or partially matches the issuer name specified in the + * varCriteria parameter. This call searches the issuer name field only. + *
+ * CERTIFICATE_FIND_ROOT_NAME + * + * Returns certificates whose root subject name exactly + * or partially matches the root subject name specified in + * the varCriteria parameter. This call creates a chain. + * This call searches the subject name field of the root certificate. + *
+ * CERTIFICATE_FIND_TEMPLATE_NAME + * + * Returns certificates whose template name matches + * the template name specified in the varCriteria parameter. + *
+ * CERTIFICATE_FIND_EXTENSION + * + * Returns certificates that have an extension + * that matches the extension specified in the + * varCriteria parameter. + *
+ * CERTIFICATE_FIND_EXTENDED_PROPERTY + * + * Returns certificates in the store that explicitly + * contain an extended property with the value specified + * in the varCriteria parameter. + *
+ * CERTIFICATE_FIND_APPLICATION_POLICY + * + * Returns certificates in the store that have + * either an enhanced key usage extension, application policy extension, + * or extended property specified in the varCriteria parameter. + *
+ * CERTIFICATE_FIND_CERTIFICATE_POLICY + * + * Returns certificates that contain the policy OID + * in the Certificate Policy extension specified + * in the varCriteria parameter. + *
+ * CERTIFICATE_FIND_TIME_VALID + * + * Returns certificates whose time is valid. + *
+ * CERTIFICATE_FIND_TIME_NOT_YET_VALID + * + * Returns certificates whose time is not yet valid. + *
+ * CERTIFICATE_FIND_TIME_EXPIRED + * + * Returns certificates whose time has expired. + *
+ * CERTIFICATE_FIND_KEY_USAGE + * + * Returns certificates containing key usages in the + * KeyUsage extension specified in the varCriteria + * parameter. If the KeyUsage extension is not present, + * all of the key usages are assumed to be unavailable. + *
+ * @param mixed $varCriteria Вариант, содержащий критерии поиска. + * Эти данные должны соответствовать типу данных, указанному в параметре FindType. + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
FindTypeТип данных
+ * CAPICOM_CERTIFICATE_FIND_SHA1_HASH, + * CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME, + * CAPICOM_CERTIFICATE_FIND_ISSUER_NAME, + * CAPICOM_CERTIFICATE_FIND_ROOT_NAME, + * CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME, + * CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY + * + * string + *
+ * CERTIFICATE_FIND_EXTENDED_PROPERTY, + * CERTIFICATE_FIND_KEY_USAGE + * + * int + *
+ * CAPICOM_CERTIFICATE_FIND_TIME_VALID, + * CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID, + * CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED + * + * string (входная строка для бъекта CDateTime, https://docs.cryptopro.ru/pki/cplib/class/cdatetime?id=cdatetime) + *
+ * + * @param bool|int $bFindValidOnly Логическое значение , указывающее, возвращаются ли только действительные сертификаты. + * Если значение равно false, возвращаются все сертификаты, соответствующие условиям поиска. + * Если значение равно true, поиск не вернет следующие типы сертификатов: + * * * @return CPCertificates */ public function Find( - int $FindType, $varCriteria = 0, bool $bFindValidOnly = false + int $FindType, $varCriteria, $bFindValidOnly ) { }