com doc/ru: Обновлен ие до англи йской верси и: reference/openssl/functions/openssl-pkcs12-expo rt-to-file.xml
reference/openssl/functions/openssl-pkcs1 2-export.xml reference/openssl/functions/openssl-pkcs1 2-read.xml
reference/openssl/functions/openssl-pkcs7-de crypt.xml reference/openssl/functions/openssl-x509-ve rify.xml
| From: | Sergey Panteleev | Date: | Wed, 17 Feb 2021 11:34:55 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: reference/openssl/functions/openssl-pkcs12-expo rt-to-file.xml reference/openssl/functions/openssl-pkcs1 2-export.xml reference/openssl/functions/openssl-pkcs1 2-read.xml reference/openssl/functions/openssl-pkcs7-de crypt.xml reference/openssl/functions/openssl-x509-ve rify.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8805@lists.php.net to get a copy of this message | ||
Commit: 4de42de4efa942b44762149feef6cce27e783638
Author: Sergey Panteleev <sergey@php.net> Wed, 17 Feb 2021 14:34:55 +0300
Parents: 425518f31658013dbe262de1b7fcea64ab8b950d
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=4de42de4efa942b44762149feef6cce27e783638
Log:
Обновление до английской версии
Changed paths:
M reference/openssl/functions/openssl-pkcs12-export-to-file.xml
M reference/openssl/functions/openssl-pkcs12-export.xml
M reference/openssl/functions/openssl-pkcs12-read.xml
M reference/openssl/functions/openssl-pkcs7-decrypt.xml
M reference/openssl/functions/openssl-x509-verify.xml
diff --git a/reference/openssl/functions/openssl-pkcs12-export-to-file.xml b/reference/openssl/functions/openssl-pkcs12-export-to-file.xml index a0d594c28..862ec8b06 100644 --- a/reference/openssl/functions/openssl-pkcs12-export-to-file.xml +++ b/reference/openssl/functions/openssl-pkcs12-export-to-file.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 904d0aeccde44f12b8e87e326febc091bf3466f9 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-export-to-file"> +<refentry xml:id="function.openssl-pkcs12-export-to-file" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_export_to_file</refname> <refpurpose>Экспортирует в совместимый с PKCS#12 файл хранилища сертификатов</refpurpose> @@ -13,16 +12,16 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_export_to_file</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>args</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type>string</type><parameter>output_filename</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_export_to_file</function> сохраняет - <parameter>x509</parameter> в файл - <parameter>filename</parameter> в формате PKCS#12. + <parameter>certificate</parameter> в файл + <parameter>output_filename</parameter> в формате PKCS#12. </para> </refsect1> @@ -32,7 +31,7 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>filename</parameter></term> + <term><parameter>output_filename</parameter></term> <listitem> <para> Путь до файла. @@ -40,16 +39,16 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>priv_key</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> Закрытый компонент ключа файла PKCS#12. - Допустимые значения см. <link linkend="openssl.certparams">Параметры закрытого/открытого ключа</link>. + Допустимые значения смотрите <link linkend="openssl.certparams">Параметры закрытого/открытого ключа</link>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для разблокировки файла PKCS#12. @@ -57,7 +56,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>args</parameter></term> + <term><parameter>options</parameter></term> <listitem> <para> Массив опций. Не описанные здесь ключи будут проигнорированы. @@ -95,8 +94,38 @@ </para> </refsect1> -</refentry> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs12-export.xml b/reference/openssl/functions/openssl-pkcs12-export.xml index f1bca0a37..fe0efdf3a 100644 --- a/reference/openssl/functions/openssl-pkcs12-export.xml +++ b/reference/openssl/functions/openssl-pkcs12-export.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-export"> +<refentry xml:id="function.openssl-pkcs12-export" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_export</refname> <refpurpose>Экспортирует совместимый с PKCS#12 файл хранилища сертификатов в переменную</refpurpose> @@ -13,11 +12,11 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_export</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter role="reference">out</parameter></methodparam> - <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>args</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type>string</type><parameter role="reference">output</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_export</function> сохраняет @@ -32,7 +31,7 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>out</parameter></term> + <term><parameter>output</parameter></term> <listitem> <para> В случае успеха будет содержать PKCS#12. @@ -40,16 +39,16 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>priv_key</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> Компонент закрытого ключа файла PKCS#12. - Список допустимых значений см. на странице <link linkend="openssl.certparams">параметров открытого/закрытого ключа</link>. + Список допустимых значений смотрите на странице <link linkend="openssl.certparams">параметров открытого/закрытого ключа</link>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для шифрования файла PKCS#12. @@ -57,7 +56,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>args</parameter></term> + <term><parameter>options</parameter></term> <listitem> <para> Массив опций. Не описанные здесь ключи будут проигнорированы. @@ -95,8 +94,37 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs12-read.xml b/reference/openssl/functions/openssl-pkcs12-read.xml index a9b6b000d..d28e0834a 100644 --- a/reference/openssl/functions/openssl-pkcs12-read.xml +++ b/reference/openssl/functions/openssl-pkcs12-read.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 4b87f18f059b7917d832cd5a6589ba5cdd9483bb Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-read"> +<refentry xml:id="function.openssl-pkcs12-read" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_read</refname> <refpurpose>Разбирает хранилище сертификатов PKCS#12 в массив</refpurpose> @@ -14,13 +13,13 @@ <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_read</methodname> <methodparam><type>string</type><parameter>pkcs12</parameter></methodparam> - <methodparam><type>array</type><parameter role="reference">certs</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> + <methodparam><type>array</type><parameter role="reference">certificates</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_read</function> разбирает хранилище сертификатов PKCS#12, заданное в <parameter>pkcs12</parameter> и помещает в массив - <parameter>certs</parameter>. + <parameter>certificates</parameter>. </para> </refsect1> @@ -37,7 +36,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>certs</parameter></term> + <term><parameter>certificates</parameter></term> <listitem> <para> В случае успеха будет содержать данные хранилища сертификата (Certificate Store Data). @@ -45,7 +44,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для расшифровки файла PKCS#12. @@ -89,7 +88,6 @@ if (openssl_pkcs12_read($cert_store, $cert_info, "my_secret_pass")) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs7-decrypt.xml b/reference/openssl/functions/openssl-pkcs7-decrypt.xml index 284d5e49e..c1c303cfe 100644 --- a/reference/openssl/functions/openssl-pkcs7-decrypt.xml +++ b/reference/openssl/functions/openssl-pkcs7-decrypt.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs7-decrypt"> +<refentry xml:id="function.openssl-pkcs7-decrypt" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs7_decrypt</refname> <refpurpose>Расшифровать сообщение, зашифрованное S/MIME</refpurpose> @@ -13,16 +12,16 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs7_decrypt</methodname> - <methodparam><type>string</type><parameter>infilename</parameter></methodparam> - <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>recipcert</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>recipkey</parameter></methodparam> + <methodparam><type>string</type><parameter>input_filename</parameter></methodparam> + <methodparam><type>string</type><parameter>output_filename</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type><type>null</type></type><parameter>private_key</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Расшифровывает сообщение, зашифрованное S/MIME, содержащееся в файле - <parameter>infilename</parameter>, с использованием сертификата - <parameter>recipcert</parameter> и соответствующего закрытого ключа - <parameter>recipkey</parameter>. + <parameter>input_filename</parameter>, с использованием сертификата + <parameter>certificate</parameter> и соответствующего закрытого ключа + <parameter>private_key</parameter>. </para> </refsect1> @@ -31,30 +30,30 @@ <para> <variablelist> <varlistentry> - <term><parameter>infilename</parameter></term> + <term><parameter>input_filename</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>outfilename</parameter></term> + <term><parameter>output_filename</parameter></term> <listitem> <para> Расшифрованное сообщение будет записано в файл - <parameter>outfilename</parameter>. + <parameter>output_filename</parameter>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>recipcert</parameter></term> + <term><parameter>certificate</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>recipkey</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> </para> @@ -71,6 +70,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -96,7 +119,6 @@ if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-x509-verify.xml b/reference/openssl/functions/openssl-x509-verify.xml index eb1cbac2c..63a99303a 100644 --- a/reference/openssl/functions/openssl-x509-verify.xml +++ b/reference/openssl/functions/openssl-x509-verify.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 0c82e58795993d5ec153386fa6aa52624f0172b1 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-x509-verify"> +<refentry xml:id="function.openssl-x509-verify" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_x509_verify</refname> <refpurpose>Проверка цифровой подписи сертификата x509 с помощью публичного ключа</refpurpose> @@ -13,14 +12,14 @@ &reftitle.description; <methodsynopsis> <type>int</type><methodname>openssl_x509_verify</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>mixed</type><parameter>pub_key_id</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>public_key</parameter></methodparam> </methodsynopsis> <para> <function>openssl_x509_verify</function> проверяет, что сертификат - <parameter>x509</parameter> был подписан приватным ключом, + <parameter>certificate</parameter> был подписан приватным ключом, соответствующим публичному ключу - <parameter>pub_key_id</parameter>. + <parameter>public_key</parameter>. </para> </refsect1> @@ -30,10 +29,10 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>pub_key_id</parameter></term> + <term><parameter>public_key</parameter></term> <listitem> <para> - <type>resource</type> - ключ, возвращённый функцией + <classname>OpenSSLAsymmetricKey</classname> - ключ, возвращённый функцией <function>openssl_get_publickey</function> </para> <para> @@ -53,6 +52,37 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>public_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -109,7 +139,6 @@ foreach($cont["options"]["ssl"]["peer_certificate_chain"] as $chaincert) </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
diff --git a/reference/openssl/functions/openssl-pkcs12-export-to-file.xml b/reference/openssl/functions/openssl-pkcs12-export-to-file.xml index a0d594c28..862ec8b06 100644 --- a/reference/openssl/functions/openssl-pkcs12-export-to-file.xml +++ b/reference/openssl/functions/openssl-pkcs12-export-to-file.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 904d0aeccde44f12b8e87e326febc091bf3466f9 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-export-to-file"> +<refentry xml:id="function.openssl-pkcs12-export-to-file" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_export_to_file</refname> <refpurpose>Экспортирует в совместимый с PKCS#12 файл хранилища сертификатов</refpurpose> @@ -13,16 +12,16 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_export_to_file</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>args</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type>string</type><parameter>output_filename</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_export_to_file</function> сохраняет - <parameter>x509</parameter> в файл - <parameter>filename</parameter> в формате PKCS#12. + <parameter>certificate</parameter> в файл + <parameter>output_filename</parameter> в формате PKCS#12. </para> </refsect1> @@ -32,7 +31,7 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>filename</parameter></term> + <term><parameter>output_filename</parameter></term> <listitem> <para> Путь до файла. @@ -40,16 +39,16 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>priv_key</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> Закрытый компонент ключа файла PKCS#12. - Допустимые значения см. <link linkend="openssl.certparams">Параметры закрытого/открытого ключа</link>. + Допустимые значения смотрите <link linkend="openssl.certparams">Параметры закрытого/открытого ключа</link>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для разблокировки файла PKCS#12. @@ -57,7 +56,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>args</parameter></term> + <term><parameter>options</parameter></term> <listitem> <para> Массив опций. Не описанные здесь ключи будут проигнорированы. @@ -95,8 +94,38 @@ </para> </refsect1> -</refentry> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs12-export.xml b/reference/openssl/functions/openssl-pkcs12-export.xml index f1bca0a37..fe0efdf3a 100644 --- a/reference/openssl/functions/openssl-pkcs12-export.xml +++ b/reference/openssl/functions/openssl-pkcs12-export.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-export"> +<refentry xml:id="function.openssl-pkcs12-export" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_export</refname> <refpurpose>Экспортирует совместимый с PKCS#12 файл хранилища сертификатов в переменную</refpurpose> @@ -13,11 +12,11 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_export</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter role="reference">out</parameter></methodparam> - <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>args</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type>string</type><parameter role="reference">output</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_export</function> сохраняет @@ -32,7 +31,7 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>out</parameter></term> + <term><parameter>output</parameter></term> <listitem> <para> В случае успеха будет содержать PKCS#12. @@ -40,16 +39,16 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>priv_key</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> Компонент закрытого ключа файла PKCS#12. - Список допустимых значений см. на странице <link linkend="openssl.certparams">параметров открытого/закрытого ключа</link>. + Список допустимых значений смотрите на странице <link linkend="openssl.certparams">параметров открытого/закрытого ключа</link>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для шифрования файла PKCS#12. @@ -57,7 +56,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>args</parameter></term> + <term><parameter>options</parameter></term> <listitem> <para> Массив опций. Не описанные здесь ключи будут проигнорированы. @@ -95,8 +94,37 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs12-read.xml b/reference/openssl/functions/openssl-pkcs12-read.xml index a9b6b000d..d28e0834a 100644 --- a/reference/openssl/functions/openssl-pkcs12-read.xml +++ b/reference/openssl/functions/openssl-pkcs12-read.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 4b87f18f059b7917d832cd5a6589ba5cdd9483bb Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-read"> +<refentry xml:id="function.openssl-pkcs12-read" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs12_read</refname> <refpurpose>Разбирает хранилище сертификатов PKCS#12 в массив</refpurpose> @@ -14,13 +13,13 @@ <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_read</methodname> <methodparam><type>string</type><parameter>pkcs12</parameter></methodparam> - <methodparam><type>array</type><parameter role="reference">certs</parameter></methodparam> - <methodparam><type>string</type><parameter>pass</parameter></methodparam> + <methodparam><type>array</type><parameter role="reference">certificates</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_read</function> разбирает хранилище сертификатов PKCS#12, заданное в <parameter>pkcs12</parameter> и помещает в массив - <parameter>certs</parameter>. + <parameter>certificates</parameter>. </para> </refsect1> @@ -37,7 +36,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>certs</parameter></term> + <term><parameter>certificates</parameter></term> <listitem> <para> В случае успеха будет содержать данные хранилища сертификата (Certificate Store Data). @@ -45,7 +44,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>pass</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Пароль для расшифровки файла PKCS#12. @@ -89,7 +88,6 @@ if (openssl_pkcs12_read($cert_store, $cert_info, "my_secret_pass")) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pkcs7-decrypt.xml b/reference/openssl/functions/openssl-pkcs7-decrypt.xml index 284d5e49e..c1c303cfe 100644 --- a/reference/openssl/functions/openssl-pkcs7-decrypt.xml +++ b/reference/openssl/functions/openssl-pkcs7-decrypt.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs7-decrypt"> +<refentry xml:id="function.openssl-pkcs7-decrypt" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_pkcs7_decrypt</refname> <refpurpose>Расшифровать сообщение, зашифрованное S/MIME</refpurpose> @@ -13,16 +12,16 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs7_decrypt</methodname> - <methodparam><type>string</type><parameter>infilename</parameter></methodparam> - <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>recipcert</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>recipkey</parameter></methodparam> + <methodparam><type>string</type><parameter>input_filename</parameter></methodparam> + <methodparam><type>string</type><parameter>output_filename</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type><type>null</type></type><parameter>private_key</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Расшифровывает сообщение, зашифрованное S/MIME, содержащееся в файле - <parameter>infilename</parameter>, с использованием сертификата - <parameter>recipcert</parameter> и соответствующего закрытого ключа - <parameter>recipkey</parameter>. + <parameter>input_filename</parameter>, с использованием сертификата + <parameter>certificate</parameter> и соответствующего закрытого ключа + <parameter>private_key</parameter>. </para> </refsect1> @@ -31,30 +30,30 @@ <para> <variablelist> <varlistentry> - <term><parameter>infilename</parameter></term> + <term><parameter>input_filename</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>outfilename</parameter></term> + <term><parameter>output_filename</parameter></term> <listitem> <para> Расшифрованное сообщение будет записано в файл - <parameter>outfilename</parameter>. + <parameter>output_filename</parameter>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>recipcert</parameter></term> + <term><parameter>certificate</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>recipkey</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> </para> @@ -71,6 +70,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -96,7 +119,6 @@ if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-x509-verify.xml b/reference/openssl/functions/openssl-x509-verify.xml index eb1cbac2c..63a99303a 100644 --- a/reference/openssl/functions/openssl-x509-verify.xml +++ b/reference/openssl/functions/openssl-x509-verify.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 0c82e58795993d5ec153386fa6aa52624f0172b1 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-x509-verify"> +<refentry xml:id="function.openssl-x509-verify" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_x509_verify</refname> <refpurpose>Проверка цифровой подписи сертификата x509 с помощью публичного ключа</refpurpose> @@ -13,14 +12,14 @@ &reftitle.description; <methodsynopsis> <type>int</type><methodname>openssl_x509_verify</methodname> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>mixed</type><parameter>pub_key_id</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>public_key</parameter></methodparam> </methodsynopsis> <para> <function>openssl_x509_verify</function> проверяет, что сертификат - <parameter>x509</parameter> был подписан приватным ключом, + <parameter>certificate</parameter> был подписан приватным ключом, соответствующим публичному ключу - <parameter>pub_key_id</parameter>. + <parameter>public_key</parameter>. </para> </refsect1> @@ -30,10 +29,10 @@ <variablelist> &openssl.param.x509; <varlistentry> - <term><parameter>pub_key_id</parameter></term> + <term><parameter>public_key</parameter></term> <listitem> <para> - <type>resource</type> - ключ, возвращённый функцией + <classname>OpenSSLAsymmetricKey</classname> - ключ, возвращённый функцией <function>openssl_get_publickey</function> </para> <para> @@ -53,6 +52,37 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>public_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -109,7 +139,6 @@ foreach($cont["options"]["ssl"]["peer_certificate_chain"] as $chaincert) </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml