[WIP] SOAP crypto_method description

Author: IMSoP

reference/soap/soapclient/construct.xml

@@ -509,15 +509,38 @@
          </term>
          <listitem>
           <para>
-           Specifies the SSL or TLS protocol version to use with secure
-           HTTP connections. Can be specified as
-           <constant>SOAP_SSL_METHOD_TLS</constant>,
-           <constant>SOAP_SSL_METHOD_SSLv2</constant>,
-           <constant>SOAP_SSL_METHOD_SSLv3</constant>, or
-           <constant>SOAP_SSL_METHOD_SSLv23</constant>.
-          </para>
-          <para>
-           TODO advise use of 'crypto_method' in context instead
+           Specifies the SSL or TLS protocol version to use with secure HTTP
+           connections, instead of the default negotiation.
+           Specifying <constant>SOAP_SSL_METHOD_SSLv2</constant>
+           or <constant>SOAP_SSL_METHOD_SSLv3</constant> will force use of SSL 2
+           or SSL 3, respectively.
+           Specifying <constant>SOAP_SSL_METHOD_SSLv23</constant> has no effect;
+           the constant exists only for backwards compatibility.
+           As of PHP 7.2, specifying <constant>SOAP_SSL_METHOD_TLS</constant>
+           also has no effect; in earlier versions, it forced use of TLS 1.0.
+          </para>
+          <para>
+           Note that SSL versions 2 and 3 are considered insecure, and may not
+           be supported by the installed OpenSSL library.
+          </para>
+          <para>
+           A more flexible alternative to this option, including specifying
+           individual versions of TLS, is to use the ''context'' option with
+           the ''crypto_method'' context parameter.
+           <example>
+            <title>Specifying use of TLS 1.3 only</title>
+            <programlisting role="php">
+<![CDATA[
+<?php
+$context = stream_context_create([
+    'ssl' => [
+        'crypto_method' => STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT
+     ]
+];
+$client = new SoapClient("some.wsdl", ['context' => $context]);
+]]>
+            </programlisting>
+           </example>
           </para>
          </listitem>
         </varlistentry>