svn: /phpdoc/de/trunk/reference/openssl/functions/ openssl-csr-export-to-file.xml openssl-csr-export.xml openssl-csr-get-public-key.xml openssl-csr-get-subject.xml openssl-csr-sign.xml openssl-open.xml openssl-pkcs12-read.xml openssl-pkcs7-encrypt.xml openssl-pkcs7-sign.xml openssl-pkey-get-private.xml openssl-pkey-get-public.xml openssl-private-decrypt.xml openssl-private-encrypt.xml openssl-public-decrypt.xml openssl-public-encrypt.xml openssl-sign.xml openssl-x509-check-private-key.xml openss

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export-to-file.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export-to-file.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export-to-file.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-csr-export-to-file">
  <refnamediv>
   <refname>openssl_csr_export_to_file</refname>
@@ -11,15 +12,15 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>openssl_csr_export_to_file</methodname>
-   <methodparam><type>resource</type><parameter>csr</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>csr</parameter></methodparam>
    <methodparam><type>string</type><parameter>outfilename</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>notext</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_csr_export_to_file</function> exportiert die mit dem
    Parameter <parameter>csr</parameter> angegebene
-   Zertifikatssignierungsanfrage und speichert diese als ASCII-armierten
-   Text in die Datei mit dem Namen <parameter>outfilename</parameter>.
+   Zertifikatssignierungsanfrage und speichert diese im PEM-Format
+   in die Datei mit dem Namen <parameter>outfilename</parameter>.
   </para>
  </refsect1>

@@ -27,14 +28,8 @@
   &reftitle.parameters;
   <para>
    <variablelist>
+    &openssl.param.csr;
     <varlistentry>
-     <term><parameter>csr</parameter></term>
-     <listitem>
-      <para>
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
      <term><parameter>outfilename</parameter></term>
      <listitem>
       <para>
@@ -59,6 +54,32 @@
   </para>
  </refsect1>

+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>openssl_csr_export_to_file() Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$subject = array(
+    "commonName" => "example.com",
+);
+$private_key = openssl_pkey_new(array(
+    "private_key_bits" => 2048,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+$csr = openssl_csr_new($subject, $private_key, array('digest_alg' => 'sha384') );
+openssl_pkey_export_to_file($private_key, 'example-priv.key');
+// Nebst dem Subjekt enthält das CSR den zum privaten Schlüssel gehörenden öffentlichen Schlüssel
+openssl_csr_export_to_file($csr, 'example-csr.pem');
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-csr-export.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
 <refentry xml:id="function.openssl-csr-export" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>openssl_csr_export</refname>
@@ -11,15 +12,15 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>openssl_csr_export</methodname>
-   <methodparam><type>resource</type><parameter>csr</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>csr</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">out</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>notext</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_csr_export</function> exportiert die mit dem Parameter
    <parameter>csr</parameter> angegebene Zertifikatssignierungsanfrage und
-   speichert diese als ASCII-armierten Text in <parameter>out</parameter>,
-   der per Referenz übergeben wird.
+   speichert diese im PEM-Format in der Zeichenkette <parameter>out</parameter>,
+   die per Referenz übergeben wird.
   </para>
  </refsect1>

@@ -27,17 +28,12 @@
   &reftitle.parameters;
   <para>
    <variablelist>
+    &openssl.param.csr;
     <varlistentry>
-     <term><parameter>csr</parameter></term>
-     <listitem>
-      <para>
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
      <term><parameter>out</parameter></term>
      <listitem>
       <para>
+       Im Erfolgsfall enthält diese Zeichenkette das im PEM-Format kodierte CSR.
       </para>
      </listitem>
     </varlistentry>
@@ -58,6 +54,34 @@
   </para>
  </refsect1>

+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>openssl_csr_export() Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$subject = array(
+    "commonName" => "example.com",
+);
+$private_key = openssl_pkey_new(array(
+    "private_key_bits" => 2048,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+$configargs = array(
+    'digest_alg' => 'sha256WithRSAEncryption'
+);
+$csr = openssl_csr_new($subject, $private_key, $configargs);
+openssl_csr_export($csr, $csr_string);
+echo $csr_string;
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -68,6 +92,7 @@
    </simplelist>
   </para>
  </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-public-key.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-public-key.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-public-key.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-csr-get-public-key">
  <refnamediv>
   <refname>openssl_csr_get_public_key</refname>
-  <refpurpose>Gibt den öffentlichen Schlüssel eines CERT zurück</refpurpose>
+  <refpurpose>Gibt den öffentlichen Schlüssel eines CSR zurück</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -12,11 +13,81 @@
   <methodsynopsis>
    <type>resource</type><methodname>openssl_csr_get_public_key</methodname>
    <methodparam><type>mixed</type><parameter>csr</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>use_shortnames</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>use_shortnames</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
-  &warn.undocumented.func;
+  <para>
+   <function>openssl_csr_get_public_key</function> extrahiert den öffentlichen
+   Schlüssel aus <parameter>csr</parameter> und bereitet ihn für die Verwendung
+   mit anderen Funktionen vor.
+  </para>
  </refsect1>

+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+     &openssl.param.csr;
+    <varlistentry>
+     <term><parameter>use_shortnames</parameter></term>
+     <listitem>
+      <warning>
+       <para>
+        Dieser Parameter wird ignoriert.
+       </para>
+      </warning>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt im Erfolgsfall eine Schlüssel-Ressourcenkennung zurück, oder &false; im
+   Fehlerfall.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>openssl_csr_get_public_key() Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$subject = array(
+    "commonName" => "example.com",
+);
+$private_key = openssl_pkey_new(array(
+    "private_key_bits" => 2048,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+$csr = openssl_csr_new($subject, $private_key, array('digest_alg' => 'sha256') );
+$public_key = openssl_csr_get_public_key($csr);
+$info = openssl_pkey_get_details($public_key);
+echo $info['key'];
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>openssl_csr_get_subject</function></member>
+    <member><function>openssl_csr_new</function></member>
+    <member><function>openssl_pkey_get_details</function></member>
+    <member><function>openssl_pkey_export_to_file</function></member>
+    <member><function>openssl_pkey_export</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-subject.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-subject.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-csr-get-subject.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-csr-get-subject">
  <refnamediv>
   <refname>openssl_csr_get_subject</refname>
-  <refpurpose>Gibt das Subject eines CERT zurück</refpurpose>
+  <refpurpose>Gibt das Subjekt eines CSR zurück</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -12,11 +13,103 @@
   <methodsynopsis>
    <type>array</type><methodname>openssl_csr_get_subject</methodname>
    <methodparam><type>mixed</type><parameter>csr</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>use_shortnames</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>use_shortnames</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
-  &warn.undocumented.func;
+  <para>
+   <function>openssl_csr_get_subject</function> gibt Informationen zum
+   Distinguished Name des Subjekt zurück, die im <parameter>csr</parameter>
+   kodiert sind, was Felder wie commonName (CN), organizationName (O),
+   countryName (C) usw. einschließt.
+  </para>
  </refsect1>

+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+     &openssl.param.csr;
+    <varlistentry>
+     <term><parameter>use_shortnames</parameter></term>
+     <listitem>
+      <para>
+       <parameter>shortnames</parameter> steuert wie die Daten im Array
+       indexiert sind – ist <parameter>shortnames</parameter> &true;
+       (Standardwert), dann werden die Felder mit ihrer kurzen Namensform
+       indexiert; andernfalls wird die lange Namensform verwendet – z.B. ist CN
+       die kurze Namensform von commonName.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>openssl_csr_get_subject() Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$subject = array(
+    "countryName" => "CA",
+    "stateOrProvinceName" => "Alberta",
+    "localityName" => "Calgary",
+    "organizationName" => "XYZ Widgets Inc",
+    "organizationalUnitName" => "PHP Documentation Team",
+    "commonName" => "Wez Furlong",
+    "emailAddress" => "[email protected]",
+);
+$private_key = openssl_pkey_new(array(
+    "private_key_bits" => 2048,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+$configargs = array(
+    'digest_alg' => 'sha512WithRSAEncryption'
+);
+$csr = openssl_csr_new($subject, $privkey, $configargs);
+print_r(openssl_csr_get_subject($csr));
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+Array
+(
+    [C] => CA
+    [ST] => Alberta
+    [L] => Calgary
+    [O] => XYZ Widgets Inc
+    [OU] => PHP Documentation Team
+    [CN] => Wez Furlong
+    [emailAddress] => [email protected]
+)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>openssl_csr_new</function></member>
+    <member><function>openssl_csr_get_public_key</function></member>
+    <member><function>openssl_x509_parse</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-csr-sign.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-csr-sign.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-csr-sign.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343014 Maintainer: nobody Status: ready -->
+
 <refentry xml:id="function.openssl-csr-sign" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>openssl_csr_sign</refname>
-  <refpurpose>Signiert einen CSR mit einem anderen Zertifikat (oder sich selbst) und generiert ein Zertifikat</refpurpose>
+  <refpurpose>Signiere einen CSR mit einem anderen Zertifikat (oder sich selbst) und generiere ein Zertifikat</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -16,7 +17,7 @@
    <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam>
    <methodparam><type>int</type><parameter>days</parameter></methodparam>
    <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>serial</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>serial</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_csr_sign</function> erzeugt eine x509
@@ -35,8 +36,8 @@
       <para>
        Ein zuvor mit <function>openssl_csr_new</function> erzeugter CSR. Es kann
        sich aber auch um den Pfad zu einer PEM-kodierten CSR-Datei in der Form
-       <filename>file://path/to/csr</filename> handeln oder einen String wie
-       von <function>openssl_csr_export</function> zurückgegeben.
+       <filename>file://path/to/csr</filename> handeln, oder einen String wie
+       von <function>openssl_csr_export</function> zurückgegeben.
       </para>
      </listitem>
     </varlistentry>
@@ -45,7 +46,7 @@
      <listitem>
       <para>
        Das generierte Zertifikat wird mit <parameter>cacert</parameter> signiert.
-       Falls Sie hier &null; angeben wird ein selbstsigniertes Zertifikat erstellt.
+       Falls hier &null; angegeben wird, wird ein selbstsigniertes Zertifikat erstellt.
       </para>
      </listitem>
     </varlistentry>
@@ -62,7 +63,7 @@
      <term><parameter>days</parameter></term>
      <listitem>
       <para>
-       <parameter>days</parameter> Die Gültigkeitsdauer des Zertifikats, in Tagen.
+       <parameter>days</parameter> gibt die Gültigkeitsdauer des Zertifikats in Tagen an.
       </para>
      </listitem>
     </varlistentry>
@@ -70,9 +71,10 @@
      <term><parameter>configargs</parameter></term>
      <listitem>
       <para>
-       Mit <parameter>configargs</parameter> können Sie die Signierung des CSR
-       feiner abstimmen.
-       Für weitere Informationen lesen Sie bitte <function>openssl_csr_new</function>.
+       Mit <parameter>configargs</parameter> kann die Signierung des CSR
+       feiner abgestimmt werden.
+       Weitere Informationen zu <parameter>configargs</parameter> sind
+       <function>openssl_csr_new</function> zu entnehmen.
       </para>
      </listitem>
     </varlistentry>
@@ -81,7 +83,7 @@
      <listitem>
       <para>
        Eine optionale Seriennummer für das ausgestellte Zertifikat. Wenn nicht
-       abgegeben wird der Standardwert 0 verwendet.
+       angegeben, wird der Standardwert 0 verwendet.
       </para>
      </listitem>
     </varlistentry>
@@ -97,36 +99,12 @@
   </para>
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.3.3</entry>
-       <entry>
-        Der Parameter <parameter>serial</parameter> wurde hinzugefügt.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title><function>openssl_csr_sign</function> example - signing a
-     CSR (how to implement your own CA)</title>
+    <title><function>openssl_csr_sign</function> Beispiel - Signieren eines
+     CSR (wie eine eigene CA implementiert wird)</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -134,11 +112,11 @@
 // eine Textarea eingegeben wurde.
 $csrdata = $_POST["CSR"];

-// Wir werden die Anfrage mit unserem eigenen ""certificate authority"
+// Wir werden die Anfrage mit unserem eigenen certificate authority"
 // Zertifikat signieren. Sie können jedes beliebige Zertifikat verwenden, um
 // ein anderes zu signieren. Aber das Ganze ist ziemlich nutzlos, solange die
 // Software/Benutzer, die dieses neu signierte Zertifikat nutzen werden, dem
-// signierenden Zertifikat
+// signierenden Zertifikat nicht vertrauen.

 // Wir brauchen unser CA Zertifikat und dessen privaten Schlüssel
 $cacert = "file://path/to/ca.crt";

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-open.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-open.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-open.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343898 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-open">
  <refnamediv>
   <refname>openssl_open</refname>
-  <refpurpose>Öffnet versiegelte Daten</refpurpose>
+  <refpurpose>Öffne versiegelte Daten</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -15,6 +16,8 @@
    <methodparam><type>string</type><parameter role="reference">open_data</parameter></methodparam>
    <methodparam><type>string</type><parameter>env_key</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>priv_key_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>method</parameter><initializer>"RC4"</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>iv</parameter></methodparam>
   </methodsynopsis>
   <para>
    Die Funktion <function>openssl_open</function> öffnet (entschlüsselt)
@@ -25,8 +28,8 @@
    open_data</parameter> mit den entschlüsselten Daten. Der
    Umschlagschlüssel wird bei der Versiegelung erzeugt und kann
    ausschlieslich für einen bestimmten privaten Schlüssel verwendet werden.
-   Mehr Informationen erhalten Sie bei der Dokumentation zu
-   <function>openssl_seal</function>.
+   Mehr Informationen sind der Dokumentation zu
+   <function>openssl_seal</function> zu entnehmen.
   </para>
  </refsect1>

@@ -45,7 +48,7 @@
      <term><parameter>open_data</parameter></term>
      <listitem>
       <para>
-       Bei erfolgreicher Ausführung werden die gelesenen Daten in diesem
+       Bei erfolgreicher Ausführung werden die geöffneten Daten in diesem
        Parameter zurückgegeben.
       </para>
      </listitem>
@@ -64,6 +67,22 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>method</parameter></term>
+     <listitem>
+      <para>
+       Die Chiffriermethode.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>iv</parameter></term>
+     <listitem>
+      <para>
+       Der Initialisierungsvektor.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -75,6 +94,34 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.0.0</entry>
+      <entry>
+       Der <parameter>iv</parameter> Parameter wurde hinzugefügt.
+      </entry>
+     </row>
+     <row>
+      <entry>5.3.0</entry>
+      <entry>
+       Der <parameter>method</parameter> Parameter wurde hinzugefügt.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -83,7 +130,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// Annahme: $sealed und $env_key enthalten versiegelte Daten und unseren
+// Annahme: $sealed und $env_key enthalten versiegelte Daten bzw. unseren
 // Umschlagschlüssel; beide haben wir von dem Versiegelnden erhalten

 // privaten Schlüssel aus einer Datei holen und vorbereiten

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs12-read.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs12-read.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs12-read.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 337797 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-read">
  <refnamediv>
   <refname>openssl_pkcs12_read</refname>
-  <refpurpose>Speichert ein PKCS#12 Zertifikat in einem Array</refpurpose>
+  <refpurpose>Parst ein PKCS#12 Zertifikatsarchiv in ein Array</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -11,13 +12,14 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>openssl_pkcs12_read</methodname>
-   <methodparam><type>mixed</type><parameter>PKCS12</parameter></methodparam>
+   <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>
   </methodsynopsis>
   <para>
-   <function>openssl_pkcs12_read</function> speichert das im Parameter <parameter>PKCS12</parameter>
-   übergebene PKCS#12 Zertifikat als Array im Parameter <parameter>certs</parameter>.
+   <function>openssl_pkcs12_read</function> parst das im Parameter
+   <parameter>PKCS12</parameter> übergebene PKCS#12 Zertifikatsarchiv in das im
+   Parameter <parameter>certs</parameter> angegebene Array.
   </para>
  </refsect1>

@@ -29,6 +31,7 @@
      <term><parameter>PKCS12</parameter></term>
      <listitem>
       <para>
+       Der Inhalt des Zertifikatsarchivs, nicht sein Dateiname.
       </para>
      </listitem>
     </varlistentry>
@@ -36,7 +39,7 @@
      <term><parameter>certs</parameter></term>
      <listitem>
       <para>
-       Enthält im Erfolgsfall die Zertifikatsdaten als Array.
+       Enthält im Erfolgsfall die Zertifikatsarchivdaten als Array.
       </para>
      </listitem>
     </varlistentry>
@@ -59,6 +62,38 @@
   </para>
  </refsect1>

+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>openssl_pkcs12_read</function> Beispiel</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+if (!$cert_store = file_get_contents("/certs/file.p12")) {
+    echo "Fehler: das Zertifikatsarchiv kann nicht gelesen werden\n";
+    exit;
+}
+
+if (openssl_pkcs12_read($cert_store, $cert_info, "my_secret_pass")) {
+    echo "Zertifikatsinformationen\n";
+    print_r($cert_info);
+} else {
+    echo "Fehler: das Zertifikatsarchiv kann nicht geparst werden.\n";
+    exit;
+}
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-encrypt.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-encrypt.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-encrypt.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 334621 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs7-encrypt">
  <refnamediv>
   <refname>openssl_pkcs7_encrypt</refname>
@@ -15,8 +16,8 @@
    <methodparam><type>string</type><parameter>outfile</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>recipcerts</parameter></methodparam>
    <methodparam><type>array</type><parameter>headers</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>cipherid</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>cipherid</parameter><initializer>OPENSSL_CIPHER_RC2_40</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_pkcs7_encrypt</function> verschlüsselt den Inhalt der Datei
@@ -62,7 +63,7 @@
       <para>
        Bei <parameter>headers</parameter> kann es sich entweder um ein assoziatives
        Array handeln, wobei der Key dem Header-Namen entspricht, oder um ein indiziertes
-       Array, bei dem jedes Element einen einzelnen Header enthält.
+       Array, bei dem jedes Element einen einzelne Headerzeile enthält.
       </para>
      </listitem>
     </varlistentry>
@@ -80,8 +81,7 @@
      <term><parameter>cipherid</parameter></term>
      <listitem>
       <para>
-       Mittels <parameter>cipherid</parameter> kann seit PHP5 der Schlüssel
-       bestimmt werden.
+       Eine der <link linkend="openssl.ciphers">Chiffre-Konstanten</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -96,30 +96,6 @@
   </para>
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>5.0.0</entry>
-       <entry>
-        Der Parameter <parameter>cipherid</parameter> wurde hinzugefügt.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -136,7 +112,8 @@

 Streng geheim!

-Der Feind rückt näher. Treffen Sie mich im Cafè um 0830.
+Der Feind rückt näher. Treffen Sie mich im Cafè um 0830,
+um ihren gefälschten Pass abzuholen.

 HQ
 EOD;
@@ -154,7 +131,7 @@
     array("To" => "[email protected]", // keyed syntax
           "From: HQ <[email protected]>", // indexed syntax
           "Subject" => "Streng geheim!"))) {
-    // message encrypted - send it!
+    // Nachricht verschlüsselt - abschicken!
     exec(ini_get("sendmail_path") . " < enc.txt");
 }
 ?>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-sign.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-sign.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-pkcs7-sign.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343361 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs7-sign">
  <refnamediv>
   <refname>openssl_pkcs7_sign</refname>
-  <refpurpose>Signieren einer S/MIME message</refpurpose>
+  <refpurpose>Signiere eine S/MIME Nachricht</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -16,7 +17,7 @@
    <methodparam><type>mixed</type><parameter>signcert</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>privkey</parameter></methodparam>
    <methodparam><type>array</type><parameter>headers</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>PKCS7_DETACHED</initializer></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -36,6 +37,7 @@
      <term><parameter>infilename</parameter></term>
      <listitem>
       <para>
+       Die Eingabedatei, die digital signiert werden soll.
       </para>
      </listitem>
     </varlistentry>
@@ -43,6 +45,7 @@
      <term><parameter>outfilename</parameter></term>
      <listitem>
       <para>
+       Die Datei, in die die digitale Signatur geschrieben werden soll.
       </para>
      </listitem>
     </varlistentry>
@@ -50,6 +53,10 @@
      <term><parameter>signcert</parameter></term>
      <listitem>
       <para>
+       Das X.509 Zertifikat, das für die digitale Signierung von infilename
+       verwendet werden soll. Gültige Werte sind dem Abschnitt <link
+       linkend="openssl.certparams">Schlüssel/Zertifikat Parameter</link> zu
+       entnehmen.
       </para>
      </listitem>
     </varlistentry>
@@ -57,6 +64,10 @@
      <term><parameter>privkey</parameter></term>
      <listitem>
       <para>
+       <parameter>privkey</parameter> ist der private Schlüssel, der zu signcert
+       gehört. Gültige Werte sind dem Abschnitt <link
+       linkend="openssl.certparams">Öffentliche/Private
+       Schlüssel-Parameter</link> zu entnehmen.
       </para>
      </listitem>
     </varlistentry>
@@ -64,10 +75,10 @@
      <term><parameter>headers</parameter></term>
      <listitem>
       <para>
-       <parameter>headers</parameter> ist ein Array aus Headern
-       die den Daten vorangestellt werden, nachdem diese signiert wurden
-       (Für mehr Informationen über das Format dieses Parameters schauen Sie
-       bei der Funktion <function>openssl_pkcs7_encrypt</function> nach).
+       <parameter>headers</parameter> ist ein Array aus Headern die den Daten
+       vorangestellt werden, nachdem diese signiert wurden (Weitere
+       Informationen über das Format dieses Parameters sind der Dokumentation zu
+       <function>openssl_pkcs7_encrypt</function> zu entnehmen).
       </para>
      </listitem>
     </varlistentry>
@@ -76,9 +87,8 @@
      <listitem>
       <para>
        Der Parameter <parameter>flags</parameter> kann zur Änderung der Ausgabe
-       benutzt werden - siehe
-       <link linkend="openssl.pkcs7.flags">PKCS7 Konstanten</link> - falls
-       nicht angegeben ist die Vorgabe PKCS7_DETACHED.
+       benutzt werden - siehe die
+       <link linkend="openssl.pkcs7.flags">PKCS7 Konstanten</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -87,7 +97,7 @@
      <listitem>
       <para>
        Der Parameter <parameter>extracerts</parameter> gibt den Namen einer Datei
-       an, die ein oder mehrere extra Zertifikate enthält, die in die Unterschrift
+       an, die ein oder mehrere extra Zertifikate enthält, die in die Signatur
        mit eingefügt werden. Das kann zum Beispiel als Hilfe für einen Empfänger
        dienen, das von Ihnen benutzte Zertifikat zu überprüfen.
       </para>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-private.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-private.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-private.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
   <refentry xml:id="function.openssl-pkey-get-private" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>openssl_pkey_get_private</refname>
-    <refpurpose>Liefert einen privaten Schlüssel</refpurpose>
+    <refpurpose>Liefere einen privaten Schlüssel</refpurpose>
    </refnamediv>

  <refsect1 role="description">
@@ -12,7 +13,7 @@
   <methodsynopsis>
    <type>resource</type><methodname>openssl_pkey_get_private</methodname>
    <methodparam><type>mixed</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter><initializer>""</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_get_privatekey</function> parst
@@ -44,7 +45,7 @@
      <term><parameter>passphrase</parameter></term>
      <listitem>
       <para>
-       Der optionale Parameter <parameter>passphrase</parameter> muß angegeben werden
+       Der optionale Parameter <parameter>passphrase</parameter> muß angegeben werden,
        falls der Schlüssel selbst verschlüsselt ist (durch eine Passphrase
        geschützt).
       </para>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-public.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-public.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-pkey-get-public.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 332644 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkey-get-public">
  <refnamediv>
   <refname>openssl_pkey_get_public</refname>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-private-decrypt.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-private-decrypt.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-private-decrypt.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 340504 Maintainer: nobody Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-private-decrypt">
  <refnamediv>
   <refname>openssl_private_decrypt</refname>
@@ -18,13 +18,13 @@
   </methodsynopsis>
   <para>
    <function>openssl_private_decrypt</function> entschlüselt
-   <parameter>data</parameter>, die zuvor mit
-   <function>openssl_public_encrypt</function> verschlüsselt wurden und
+   <parameter>data</parameter>, das zuvor mit
+   <function>openssl_public_encrypt</function> verschlüsselt wurde, und
    speichert das Ergebnis in <parameter>decrypted</parameter>.
   </para>
   <para>
-   Mit dieser Funktion können beispielweise Daten entschlüsselt werden die
-   einzig für Sie bestimmt sind.
+   Mit dieser Funktion können beispielweise Daten entschlüsselt werden, die
+   nur für einen bestimmten Empfänger gedacht sind.
   </para>
  </refsect1>

@@ -59,8 +59,8 @@
      <term><parameter>padding</parameter></term>
      <listitem>
       <para>
-       <parameter>padding</parameter> ist per Standard
-       <constant>OPENSSL_PKCS1_PADDING</constant>, kann aber auch eine der Konstanten
+       <parameter>padding</parameter> kann eine der Konstanten
+       <constant>OPENSSL_PKCS1_PADDING</constant>,
        <constant>OPENSSL_SSLV23_PADDING</constant>,
        <constant>OPENSSL_PKCS1_OAEP_PADDING</constant> oder
        <constant>OPENSSL_NO_PADDING</constant> sein.

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-private-encrypt.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-private-encrypt.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-private-encrypt.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-private-encrypt">
  <refnamediv>
   <refname>openssl_private_encrypt</refname>
@@ -14,19 +15,19 @@
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">crypted</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>padding</parameter><initializer>OPENSSL_PKCS1_PADDING</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_private_encrypt</function> verschlüsselt
-   <parameter>data</parameter> mit dem privaten <parameter>key</parameter>
+   <parameter>data</parameter> mit dem privaten <parameter>key</parameter>,
    und speichert das Ergebnis in <parameter>crypted</parameter>.
-   Verschlüsselte Daten können Sie mit
-   <function>openssl_public_decrypt</function> entschlüsseln.
+   Verschlüsselte Daten können mit
+   <function>openssl_public_decrypt</function> entschlüsselt werden.
   </para>
   <para>
-   Zum Beispiel können Sie diese Funktion benutzen um Daten (oder deren
+   Zum Beispiel kann diese Funktion verwendet werden, um Daten (oder deren
    Hashwert) zu signieren um damit sicher zu stellen, dass diese Daten
-   wirklich von Ihnen selbst stammen und nicht von jemanden anders.
+   wirklich von einem bestimmten Sender stammen, und nicht von jemand anderem.
   </para>
  </refsect1>

@@ -59,9 +60,9 @@
      <term><parameter>padding</parameter></term>
      <listitem>
       <para>
-       <parameter>padding</parameter> ist per Standard
-       <constant>OPENSSL_PKCS1_PADDING</constant>, kann aber auch
-       <constant>OPENSSL_NO_PADDING</constant> sein.
+       <parameter>padding</parameter> ist entweder
+       <constant>OPENSSL_PKCS1_PADDING</constant> oder
+       <constant>OPENSSL_NO_PADDING</constant>.
       </para>
      </listitem>
     </varlistentry>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-public-decrypt.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-public-decrypt.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-public-decrypt.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-public-decrypt">
  <refnamediv>
   <refname>openssl_public_decrypt</refname>
@@ -14,15 +15,15 @@
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">decrypted</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>padding</parameter><initializer>OPENSSL_PKCS1_PADDING</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_public_decrypt</function> entschlüsselt <parameter>data</parameter>,
-   die zuvor mit <function>openssl_private_encrypt</function> verschlüsselt
-   wurden und speichert das Ergebnis in <parameter>decrypted</parameter>.
+   das zuvor mit <function>openssl_private_encrypt</function> verschlüsselt
+   wurde, und speichert das Ergebnis in <parameter>decrypted</parameter>.
   </para>
   <para>
-   Sie können diese Funktion beispielsweise verwenden um zu überprüfen, ob eine
+   diese Funktion kann beispielsweise verwendet werden, um zu überprüfen, ob eine
    Nachricht wirklich vom Eigentümer des privaten Schlüssels geschrieben wurde.
   </para>
  </refsect1>
@@ -49,8 +50,8 @@
      <term><parameter>key</parameter></term>
      <listitem>
       <para>
-       <parameter>key</parameter> muss der öffentliche Schlüssel sein der mit dem
-       privaten Schlüssel übereinstimmt mit dem die Daten verschlüsselt wurden.
+       <parameter>key</parameter> muss der öffentliche Schlüssel sein, der zum
+       privaten Schlüssel gehört, mit dem die Daten verschlüsselt wurden.
       </para>
      </listitem>
     </varlistentry>
@@ -58,9 +59,9 @@
      <term><parameter>padding</parameter></term>
      <listitem>
       <para>
-       Für <parameter>padding</parameter> ist
-       <constant>OPENSSL_PKCS1_PADDING</constant> voreingestellt, zulässig ist
-       aber auch <constant>OPENSSL_NO_PADDING</constant>.
+       Für <parameter>padding</parameter> ist entweder
+       <constant>OPENSSL_PKCS1_PADDING</constant> oder
+       <constant>OPENSSL_NO_PADDING</constant>.
       </para>
      </listitem>
     </varlistentry>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-public-encrypt.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-public-encrypt.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-public-encrypt.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-public-encrypt">
  <refnamediv>
   <refname>openssl_public_encrypt</refname>
@@ -14,17 +15,19 @@
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">crypted</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>padding</parameter><initializer>OPENSSL_PKCS1_PADDING</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_public_encrypt</function> verschlüsselt <parameter>data</parameter>
-   mit dem öffentlichen Schlüssel <parameter>key</parameter> und speichert das
+   mit dem öffentlichen Schlüssel <parameter>key</parameter>, und speichert das
    Ergebnis in <parameter>crypted</parameter>. Verschlüsselte Daten können
    mittels <function>openssl_private_decrypt</function> entschlüsselt werden.
   </para>
   <para>
-   Mit dieser Funktion können Sie beispielsweise eine Nachricht verschlüsseln so
-   daß sie nur vom Eigentümer des privaten Schlüssels gelesen werden kann.
+   Mit dieser Funktion kann beispielsweise eine Nachricht verschlüsselt werden, so
+   daß sie nur vom Eigentümer des privaten Schlüssels gelesen werden kann.
+   Es kann ebenfalls verwendet werden, um Daten sicher in einer Datenbank zu
+   speichern.
   </para>
  </refsect1>

@@ -59,11 +62,11 @@
      <term><parameter>padding</parameter></term>
      <listitem>
       <para>
-       Für <parameter>padding</parameter> ist als Standard
-       <constant>OPENSSL_PKCS1_PADDING</constant> voreingestellt, aber auch
+       Für <parameter>padding</parameter> ist entweder
+       <constant>OPENSSL_PKCS1_PADDING</constant>,
        <constant>OPENSSL_SSLV23_PADDING</constant>,
        <constant>OPENSSL_PKCS1_OAEP_PADDING</constant> oder
-       <constant>OPENSSL_NO_PADDING</constant> sind zulässige Werte.
+       <constant>OPENSSL_NO_PADDING</constant>.
       </para>
      </listitem>
     </varlistentry>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-sign.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-sign.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-sign.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 334621 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-sign">
  <refnamediv>
   <refname>openssl_sign</refname>
@@ -14,14 +15,14 @@
    <methodparam><type>string</type><parameter>data</parameter></methodparam>
    <methodparam><type>string</type><parameter role="reference">signature</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>priv_key_id</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>signature_alg</parameter></methodparam>
+   <methodparam choice="opt"><type>mixed</type><parameter>signature_alg</parameter><initializer>OPENSSL_ALGO_SHA1</initializer></methodparam>
   </methodsynopsis>
   <para>
-   <function>openssl_sign</function> errechnet eine Signatur für die im Parameter
-   <parameter>data</parameter> angegebenen Daten. Dazu werden die Daten zunächst
-   mit SHA1 gehasht und dann unter Verwendung des in
-   <parameter>priv_key_id</parameter> angegebenen privaten Schlüssels verschlüsselt.
-   Bitte beachten Sie daß die Daten selbst nicht verschlüsselt werden.
+   <function>openssl_sign</function> errechnet eine Signatur für die im
+   Parameter <parameter>data</parameter> angegebenen Daten, durch die Erzeugung
+   einer kryptographischen digitalen Signatur unter Verwendung des privaten
+   Schlüssels <parameter>priv_key_id</parameter>. Es ist zu beachten, daß die
+   Daten selbst nicht verschlüsselt werden.
   </para>
  </refsect1>

@@ -33,6 +34,7 @@
      <term><parameter>data</parameter></term>
      <listitem>
       <para>
+       Die zu verschlüsselnden Daten.
       </para>
      </listitem>
     </varlistentry>
@@ -49,7 +51,11 @@
      <term><parameter>priv_key_id</parameter></term>
      <listitem>
       <para>
+       <type>resource</type> - ein von <function>openssl_get_privatekey</function> gelieferter Schlüssel
       </para>
+      <para>
+       <type>string</type> - ein Schlüssel im PEM-Format
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -56,10 +62,12 @@
      <term><parameter>signature_alg</parameter></term>
      <listitem>
       <para>
-       Standard ist <constant>OPENSSL_ALGO_SHA1</constant>. Für weitere
-       Informationen siehe
-       <link linkend="openssl.signature-algos">Signatur-Algorithmen</link>.
+       <type>int</type> - einer dieser <link linkend="openssl.signature-algos">Signatur-Algorithmen</link>.
       </para>
+      <para>
+       <type>string</type> - eine gültige Zeichenkette wie von <function>openssl_get_md_methods</function>
+       zurückgegeben. Beispielsweise "sha256WithRSAEncryption" oder "sha384".
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -73,55 +81,61 @@
   </para>
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>5.0.0</entry>
-       <entry>
-        Der Parameter <parameter>signature_alg</parameter> wurde hinzugefügt.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title><function>openssl_sign</function> example</title>
+    <title><function>openssl_sign</function> Beispiel</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// Annahme: $data enthält die Daten, die signiert werden sollen.
+// Annahme: $data enthält die Daten, die signiert werden sollen

-// holen und vorbereiten des privaten Schlüssels aus einer Datei.
-$fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r");
-$priv_key = fread($fp, 8192);
-fclose($fp);
-$pkeyid = openssl_get_privatekey($priv_key);
+// holen und vorbereiten des privaten Schlüssels aus einer Datei
+$pkeyid = openssl_pkey_get_private("file://src/openssl-0.9.6/demos/sign/key.pem");

-// errechnen der Unterschrift
+// errechnen der Signatur
 openssl_sign($data, $signature, $pkeyid);

-// Löschen des Schlüssels aus dem Speicher
+// löschen des Schlüssels aus dem Speicher
 openssl_free_key($pkeyid);
 ?>
 ]]>
     </programlisting>
    </example>
+   <example>
+    <title><function>openssl_sign</function> Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// die zu verschlüssenlnden Daten
+$data = 'my data';
+
+// erzeuge einen neuen privaten und öffentlichen Schlüssel
+$new_key_pair = openssl_pkey_new(array(
+    "private_key_bits" => 2048,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+openssl_pkey_export($new_key_pair, $private_key_pem);
+
+$details = openssl_pkey_get_details($new_key_pair);
+$public_key_pem = $details['key'];
+
+// erzeuge die Signatur
+openssl_sign($data, $signature, $private_key_pem, OPENSSL_ALGO_SHA256);
+
+// für späteren Gebrauch speichern
+file_put_contents('private_key.pem', $private_key_pem);
+file_put_contents('public_key.pem', $public_key_pem);
+file_put_contents('signature.dat', $signature);
+
+// Signatur überprüfen
+$r = openssl_verify($data, $signature, $public_key_pem, "sha256WithRSAEncryption");
+var_dump($r);
+?>
+]]>
+    </programlisting>
+   </example>
   </para>
  </refsect1>


Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-x509-check-private-key.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-x509-check-private-key.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-x509-check-private-key.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 342690 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-x509-check-private-key">
  <refnamediv>
   <refname>openssl_x509_check_private_key</refname>
@@ -18,6 +19,19 @@
    Prüft ob der übergebene Schlüssel <parameter>key</parameter> der private Schlüssel
    zum Zertifikat <parameter>cert</parameter> ist.
   </para>
+  <warning>
+    <para>
+     Die Funktion überprüft nicht, ob <parameter>key</parameter> tatsächlich ein
+     privater Schlüssel ist. Sie vergleicht lediglich die öffentlichen
+     Bestandteile (u.B. Exponent und Modulus eines RSA-Schlüssels) und/oder die
+     Schlüsselparameter (z.B. die EC-Parameter eines EC-Schlüssels).
+    </para>
+    <para>
+     Dies bedeutet beispielsweise, dass ein öffentlicher Schlüssel als
+     <parameter>key</parameter> angegeben werden kann, woraufhin die Funktion
+     möglicherweise &true; zurückgibt.
+    </para>
+  </warning>
  </refsect1>

  <refsect1 role="parameters">
@@ -28,7 +42,7 @@
      <term><parameter>cert</parameter></term>
      <listitem>
       <para>
-       Das Zertifikat
+       Das Zertifikat.
       </para>
      </listitem>
     </varlistentry>
@@ -47,7 +61,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt &true; zurück wenn  <parameter>key</parameter> der private Schlüssel
+   Gibt &true; zurück, wenn  <parameter>key</parameter> der private Schlüssel
    zum Zertifikat <parameter>cert</parameter>ist, andernfalls &false;.
   </para>
  </refsect1>

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-x509-free.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-x509-free.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-x509-free.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,25 +1,50 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
- <refentry xml:id="function.openssl-x509-free" xmlns="http://docbook.org/ns/docbook">
-  <refnamediv>
-   <refname>openssl_x509_free</refname>
-   <refpurpose>Freigabe einer Zertifikats Resource</refpurpose>
-  </refnamediv>
-  <refsect1>
-   <title>Beschreibung</title>
-    <methodsynopsis>
-     <type>void</type><methodname>openssl_x509_free</methodname>
-     <methodparam><type>resource</type><parameter>x509cert</parameter></methodparam>
-    </methodsynopsis>
-   <para>
-    Die Funktion <function>openssl_x509_free</function> gibt den
-    Speicherbereich frei, der von einer Zertifikatsressource
-    <parameter>x509cert</parameter> belegt wurde.
-   </para>
-  </refsect1>
- </refentry>
+<!-- EN-Revision: 297028 Maintainer: nobody Status: ready -->

+<refentry xml:id="function.openssl-x509-free" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_x509_free</refname>
+  <refpurpose>Freigabe einer Zertifikats Resource</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>openssl_x509_free</methodname>
+   <methodparam><type>resource</type><parameter>x509cert</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Die Funktion <function>openssl_x509_free</function> gibt den
+   Speicherbereich frei, der von der Zertifikatsressource
+   <parameter>x509cert</parameter> belegt wird.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>x509cert</parameter></term>
+     <listitem>
+      <para>
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/de/trunk/reference/openssl/functions/openssl-x509-parse.xml
===================================================================
--- phpdoc/de/trunk/reference/openssl/functions/openssl-x509-parse.xml	2018-04-12 09:47:40 UTC (rev 344660)
+++ phpdoc/de/trunk/reference/openssl/functions/openssl-x509-parse.xml	2018-04-12 13:00:33 UTC (rev 344661)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: nobody Status: ready -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-x509-parse">
  <refnamediv>
   <refname>openssl_x509_parse</refname>
@@ -13,7 +14,7 @@
   <methodsynopsis>
    <type>array</type><methodname>openssl_x509_parse</methodname>
    <methodparam><type>mixed</type><parameter>x509cert</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>shortnames</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>shortnames</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>openssl_x509_parse</function> liefert Informationen über das per