cvs: phpdoc /en/language/context ssl.xml
| From: | Pedram Salehpoor | Date: | Wed, 02 Jul 2008 16:34:38 +0000 |
| Subject: | cvs: phpdoc /en/language/context ssl.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-1818@lists.php.net to get a copy of this message | ||
psalehpoor Wed Jul 2 16:34:38 2008 UTC
Modified files:
/phpdoc/en/language/context ssl.xml
Log:
blah I corrected my mistake so sorry
http://cvs.php.net/viewvc.cgi/phpdoc/en/language/context/ssl.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc/en/language/context/ssl.xml
diff -u phpdoc/en/language/context/ssl.xml:1.3 phpdoc/en/language/context/ssl.xml:1.4
--- phpdoc/en/language/context/ssl.xml:1.3 Wed Jul 2 16:27:56 2008
+++ phpdoc/en/language/context/ssl.xml Wed Jul 2 16:34:38 2008
@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1.2 Maintainer: pedram Status: ready -->
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<refentry xml:id="context.ssl" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
role="noversion">
<refnamediv>
- <refname>گزÛÙÙâÙØ§Û Ù
تÙSSL</refname>
- <refpurpose>ÙÙØ±Ø³Øª گزÛÙÙâÙØ§Û Ù
تÙ
SSL</refpurpose>
+ <refname>SSL context options</refname>
+ <refpurpose>SSL context option listing</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
- گزÛÙÙâÙØ§Û Ù
ت٠براÛ
Ø§ÙØªÙØ§ÙØ§Øª <literal>ssl://</literal> Ù
<literal>tls://</literal>.
+ Context options for <literal>ssl://</literal> and
<literal>tls://</literal>
+ transports.
</para>
</refsect1>
@@ -26,10 +26,10 @@
</term>
<listitem>
<para>
- ÙÛØ§Ø²Ù
ÙØ¯ تاÛÛØ¯ Ú¯ÙØ§ÙÛÙØ§Ù
Ù SSL.
+ Require verification of SSL certificate used.
</para>
<para>
- Ø¨ØµÙØ±Øª Ù¾ÛØ´Ùرض &false;.
+ Defaults to &false;.
</para>
</listitem>
</varlistentry>
@@ -40,10 +40,10 @@
</term>
<listitem>
<para>
- اÙ
کاÙ
Ú¯ÙØ§ÙÛÙØ§Ù
ÙâÙØ§Û
Ø®ÙØ¯Ø§Ù
ضا.
+ Allow self-signed certificates.
</para>
<para>
- Ø¨ØµÙØ±Øª Ù¾ÛØ´âÙØ±Ø¶ &false;
+ Defaults to &false;
</para>
</listitem>
</varlistentry>
@@ -54,9 +54,9 @@
</term>
<listitem>
<para>
- Ù
Ú©Ø§Ù ÙØ§Û٠تاÛÛØ¯ ÙÙÛØª در
Ø³ÛØ³ØªÙ
ÙØ§ÛÙ Ù
ØÙÛ Ø¨Ù ÙÙ
راÙ
- گزÛÙÙ Ù
ت٠<literal>verify_peer</literal>
- Ø¨Ø±Ø§Û ØªØ§ÛÛØ¯ ÙÙÛØª ÙÙØ·Ù Ø¯ÙØ±
Ø§Ø³ØªÙØ§Ø¯Ù Ù
ÛâØ´ÙØ¯.
+ Location of Certificate Authority file on local filesystem
+ which should be used with the <literal>verify_peer</literal>
+ context option to authenticate the identity of the remote peer.
</para>
</listitem>
</varlistentry>
@@ -67,9 +67,10 @@
</term>
<listitem>
<para>
- اگر <literal>cafile</literal> تعÛÛÙ ÙØ´Ø¯Ù
باشد ÛØ§ اگر Ú¯ÙØ§ÙÛÙØ§Ù
Ù ÛØ§Ùت
ÙØ´Ùد Ø¯Ø§ÛØ±Ú©ØªÙØ±Û Ø§Ø´Ø§Ø±Ù Ø´Ø¯Ù
- با <literal>capath</literal> جستجÙ
Ù
Ûâگردد تا Ú¯ÙØ§ÙÛÙØ§Ù
Ù ÙØ§Ø²Ù
ÛØ§Ùت Ø´ÙØ¯. <literal>capath</literal>
- Ø¨Ø§ÛØ¯ ÛÚ© Ø¯Ø§ÛØ±Ú©ØªÙرÛ
درÙÙ
âØ³Ø§Ø²Û Ø´Ø¯Ù Ú¯ÙØ§ÙÛÙØ§Ù
Ù
باشد.
+ If <literal>cafile</literal> is not specified or if the certificate
+ is not found there, the directory pointed to by <literal>capath</literal>
+ is searched for a suitable certificate. <literal>capath</literal>
+ must be a correctly hashed certificate directory.
</para>
</listitem>
</varlistentry>
@@ -80,9 +81,9 @@
</term>
<listitem>
<para>
- Ù
Ø³ÛØ± ÙØ§ÛÙ Ú¯ÙØ§ÙÛÙØ§Ù
Ù Ù
ØÙÛ
در Ø³ÛØ³ØªÙ
ÙØ§ÛÙ. Ø¨Ø§ÛØ¯ ÛÚ© ÙØ§ÛÙ
Ú©Ø¯Ú¯Ø°Ø§Ø±Û Ø´Ø¯Ù PEM
- شاÙ
Ù Ú¯ÙØ§ÙÛÙØ§Ù
Ù Ø´Ù
ا Ù Ú©ÙÛØ¯
Ø®ØµÙØµÛ را شاÙ
٠باشد.
- Ù
ÛâØªÙØ§Ùد Ø¨ØµÙØ±Øª Ø§Ø®ØªÛØ§Ø±Û
شاÙ
Ù Ø²ÙØ¬Ûر٠صادرکÙÙØ¯Ú¯Ø§Ù
Ú¯ÙØ§ÙÛÙØ§Ù
Ù ÙÙ
باشد.
+ Path to local certificate file on filesystem. It must be a PEM
+ encoded file which contains your certificate and private key.
+ It can optionally contain the certificate chain of issuers.
</para>
</listitem>
</varlistentry>
@@ -93,7 +94,8 @@
</term>
<listitem>
<para>
- Passphrase ک٠با Ø¢Ù ÙØ§ÛÙ
<literal>local_cert</literal> Ú©Ø¯Ú¯Ø°Ø§Ø±Û Ú¯Ø±Ø¯ÛØ¯Ù
است.
+ Passphrase with which your <literal>local_cert</literal> file
+ was encoded.
</para>
</listitem>
</varlistentry>
@@ -104,8 +106,9 @@
</term>
<listitem>
<para>
- اساÙ
Û Ù
عÙ
Ù٠را Ù
ا Ø§ÙØªØ¸Ø§Ø±
دارÛÙ
. PHP تÙÙØ§ تعداد Ù
ØØ¯ÙدÛ
تطبÛÙ Ø§ÙØ¬Ø§Ù
Ù
ÛâØ¯ÙØ¯.
- اگر اساÙ
Û Ù
عÙ
Ù٠تطبÛÙ
ÙØ¯Ø§Ø´ØªÙد اÛÙ ØªÙØ§Ø´ Ø¨Ø±Ø§Û Ø§ØªØµØ§Ù
شکست Ø®ÙØ§Ùد Ø®ÙØ±Ø¯.
+ Common Name we are expecting. PHP will perform limited wildcard
+ matching. If the Common Name does not match this, the connection
+ attempt will fail.
</para>
</listitem>
</varlistentry>
@@ -116,7 +119,7 @@
</term>
<listitem>
<para>
- اگر Ø²ÙØ¬ÛØ±Ù Ú¯ÙØ§ÙÛÙØ§Ù
Ù
سÙÚ¯ÛÙ Ø¨ÙØ¯ Ù¾Ø§ÛØ§Ù بدÙ.
+ Abort if the certificate chain is too deep.
</para>
<para>
Defaults to no verification.
@@ -130,11 +133,11 @@
</term>
<listitem>
<para>
- ÙÙØ±Ø³Øª رÙ
زÙÚ¯Ø§Ø±Û Ù
ÙØ¬Ùد را
تعÛÛÙ Ù
ÛâÙÙ
Ø§ÛØ¯. ÙØ§Ùب رشتÙ
ØªÙØ³Ø·
- <link xlink:href="&url.openssl.ciphers;">ciphers(1)</link>
تعÛÛ٠شد٠است.
+ Sets the list of available ciphers. The format of the string is described
+ in <link xlink:href="&url.openssl.ciphers;">ciphers(1)</link>.
</para>
<para>
- Ø¨ØµÙØ±Øª Ù¾ÛØ´Ùرض <literal>DEFAULT</literal>.
+ Defaults to <literal>DEFAULT</literal>.
</para>
</listitem>
</varlistentry>
@@ -145,8 +148,8 @@
</term>
<listitem>
<para>
- اگر برابر با &true; باشد ÛÚ©
گزÛÙÙ Ù
ت٠<literal>peer_certificate</literal> شاÙ
Ù
Ú¯ÙØ§ÙÛÙØ§Ù
Ù ÙÙØ·Ù را
- Ø®ÙØ§Ùد ساخت.
+ If set to &true; a <literal>peer_certificate</literal> context option
+ will be created containing the peer certificate.
</para>
</listitem>
</varlistentry>
@@ -157,7 +160,8 @@
</term>
<listitem>
<para>
- اگر برابر با&true; باشد ÛÚ©
گزÛÙÙ Ù
ت٠<literal>peer_certificate_chain</literal>
شاÙ
Ù Ø²ÙØ¬ÛØ±Ù Ú¯ÙØ§ÙÛÙØ§Ù
٠ساختÙ
Ø®ÙØ§Ùد شد.
+ If set to &true; a <literal>peer_certificate_chain</literal> context
+ option will be created containing the certificate chain.
</para>
</listitem>
</varlistentry>
@@ -180,9 +184,9 @@
<row>
<entry>5.0.0</entry>
<entry>
- <parameter>capture_peer_cert</parameter>Ù¬
- <parameter>capture_peer_chain</parameter> Ù
- <parameter>ciphers</parameter> را اضاÙÙ ÙÙ
ÙØ¯.
+ Added <parameter>capture_peer_cert</parameter>,
+ <parameter>capture_peer_chain</parameter> and
+ <parameter>ciphers</parameter>.
</entry>
</row>
</tbody>
@@ -195,11 +199,11 @@
&reftitle.notes;
<note>
<simpara>
- بدÙÛÙ Ø²ÛØ±Ø³Ø§Ø®ØªØ§Ø± Ø¨ÙØ¯Ù
<literal>ssl://</literal> براÛ
Ù¾ÙØ´Ø§ÙÙØ¯ÙâÙØ§Û
- <link linkend="wrappers.http"><literal>https://</literal></link> Ù
- <link
linkend="wrappers.ftp"><literal>ftps://</literal></link> ÙØ±
گزÛÙÙ Ù
تÙ
- Ø¨Ø±Ø§Û <literal>ssl://</literal> در Ù
ÙØ±Ø¯
- <literal>https://</literal> Ù
<literal>ftps://</literal> ÙÛØ² صاد٠است.
+ Because <literal>ssl://</literal> is the underlying transport for the
+ <link linkend="wrappers.http"><literal>https://</literal></link> and
+ <link
linkend="wrappers.ftp"><literal>ftps://</literal></link> wrappers,
+ any context options which apply to <literal>ssl://</literal> also apply to
+ <literal>https://</literal> and
<literal>ftps://</literal>.
</simpara>
</note>
</refsect1>