svn: /phpdoc/en/trunk/ language/context/ssl.xml reference/openssl/constants.xml
| From: | Kalle Sommer Nielsen | Date: | Wed, 23 Dec 2009 16:18:22 +0000 |
| Subject: | svn: /phpdoc/en/trunk/ language/context/ssl.xml reference/openssl/constants.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-5705@lists.php.net to get a copy of this message | ||
kalle Wed, 23 Dec 2009 16:18:22 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=292542
Log:
Documented SNI support in OpenSSL from 5.3.2 (closes #50336)
Bug: http://bugs.php.net/50336 (To be documented) [TBD] for
server name indication support in openssl
Changed paths:
U phpdoc/en/trunk/language/context/ssl.xml
U phpdoc/en/trunk/reference/openssl/constants.xml
Modified: phpdoc/en/trunk/language/context/ssl.xml
===================================================================
--- phpdoc/en/trunk/language/context/ssl.xml 2009-12-23 16:16:41 UTC (rev 292541)
+++ phpdoc/en/trunk/language/context/ssl.xml 2009-12-23 16:18:22 UTC (rev 292542)
@@ -165,6 +165,31 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry xml:id="context.ssl.sni-enabled">
+ <term>
+ <parameter>SNI_enabled</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ If set to &true; server name indication will be enabled. Enabling SNI
+ allows multiple certificates on the same IP address.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="context.ssl.sni-server-name">
+ <term>
+ <parameter>SNI_server_name</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ If set, then this value will be used as server name for server name
+ indication. If this value is not set, then the server name is guessed
+ based on the hostname used when opening the stream.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1><!-- }}} -->
@@ -182,6 +207,13 @@
</thead>
<tbody>
<row>
+ <entry>5.3.2</entry>
+ <entry>
+ Added <parameter>SNI_enabled</parameter> and
+ <parameter>SNI_server_name</parameter>.
+ </entry>
+ </row>
+ <row>
<entry>5.0.0</entry>
<entry>
Added <parameter>capture_peer_cert</parameter>,
@@ -205,6 +237,12 @@
any context options which apply to <literal>ssl://</literal> also apply to
<literal>https://</literal> and
<literal>ftps://</literal>.
</simpara>
+ <simpara>
+ For SNI (Server Name Indication) to be available, then PHP must be compiled
+ with OpenSSL 0.9.8j or greater. Use the
+ <constant>OPENSSL_TLSEXT_SERVER_NAME</constant> to determine whether SNI is
+ supported.
+ </simpara>
</note>
</refsect1>
Modified: phpdoc/en/trunk/reference/openssl/constants.xml
===================================================================
--- phpdoc/en/trunk/reference/openssl/constants.xml 2009-12-23 16:16:41 UTC (rev 292541)
+++ phpdoc/en/trunk/reference/openssl/constants.xml 2009-12-23 16:18:22 UTC (rev 292542)
@@ -427,6 +427,26 @@
<para>These constants were added in 5.2.0.</para>
</note>
</section>
+
+ <section xml:id="openssl.constsni">
+ <title>Version constants</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <constant>OPENSSL_TLSEXT_SERVER_NAME</constant>
+ (<type>string</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Whether SNI support is available or not.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <note>
+ <para>This constant were added in 5.3.2.</para>
+ </note>
+ </section>
</appendix>