svn: /phpdoc/zh/trunk/reference/session/ ini.xml
[email protected] (Dai Jie) Fri, 26 Jul 2019 18:39:19 +0000
| Newsgroups | php.doc.zh |
|---|---|
| Message-ID | <[email protected]> |
daijie Fri, 26 Jul 2019 18:39:19 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=347804
Log:
Add missing sections
Changed paths:
U phpdoc/zh/trunk/reference/session/ini.xml
svn-diffs-347804.txt
(text/x-diff, 16.7 KB)
Modified: phpdoc/zh/trunk/reference/session/ini.xml
===================================================================
--- phpdoc/zh/trunk/reference/session/ini.xml 2019-07-26 12:16:15 UTC (rev 347803)
+++ phpdoc/zh/trunk/reference/session/ini.xml 2019-07-26 18:39:19 UTC (rev 347804)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 335235 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 347259 Maintainer: HonestQiao Status: ready -->
<!-- Reviewed: no Maintainer: HonestQiao -->
<section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
@@ -52,7 +52,7 @@
<entry><link linkend="ini.session.gc-divisor">session.gc_divisor</link></entry>
<entry>"100"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.3.2 起可用。</entry>
+ <entry></entry>
</row>
<row>
<entry><link linkend="ini.session.gc-maxlifetime">session.gc_maxlifetime</link></entry>
@@ -88,19 +88,25 @@
<entry><link linkend="ini.session.cookie-secure">session.cookie_secure</link></entry>
<entry>""</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.0.4 起有效。</entry>
+ <entry></entry>
</row>
<row>
<entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry>
<entry>""</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 5.2.0. 有效</entry>
- </row>
+ <entry>自 PHP 5.2.0 起有效</entry>
+ </row>
<row>
+ <entry><link linkend="ini.session.cookie-samesite">session.cookie_samesite</link></entry>
+ <entry>""</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 7.3.0 起有效</entry>
+ </row>
+ <row>
<entry><link linkend="ini.session.use-strict-mode">session.use_strict_mode</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 5.5.2. 有效</entry>
+ <entry>自 PHP 5.5.2 起有效</entry>
</row>
<row>
<entry><link linkend="ini.session.use-cookies">session.use_cookies</link></entry>
@@ -112,7 +118,7 @@
<entry><link linkend="ini.session.use-only-cookies">session.use_only_cookies</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.3.0 起可用。</entry>
+ <entry></entry>
</row>
<row>
<entry><link linkend="ini.session.referer-check">session.referer_check</link></entry>
@@ -121,108 +127,131 @@
<entry></entry>
</row>
<row>
- <entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry>
- <entry>""</entry>
+ <entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry>
+ <entry>"nocache"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
- <entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry>
- <entry>"0"</entry>
+ <entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry>
+ <entry>"180"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
- <entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry>
- <entry>"nocache"</entry>
+ <entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry>
+ <entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
- <entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry>
- <entry>"180"</entry>
+ <entry><link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link></entry>
+ <entry>"a=href,area=href,frame=src,form="</entry>
<entry>PHP_INI_ALL</entry>
- <entry></entry>
+ <entry>自 PHP 7.1.0 起有效。</entry>
</row>
<row>
- <entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry>
- <entry>"0"</entry>
+ <entry><link linkend="ini.session.trans-sid-hosts">session.trans_sid_hosts</link></entry>
+ <entry><literal>$_SERVER['HTTP_HOST']</literal></entry>
<entry>PHP_INI_ALL</entry>
- <entry>在 PHP <= 4.2.3 是 PHP_INI_ALL，在 PHP < 5 是 PHP_INI_PERDIR。自 PHP 4.0.3 起可用。</entry>
+ <entry>自 PHP 7.1.0 起有效。</entry>
</row>
<row>
- <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry>
- <entry>"1"</entry>
+ <entry><link linkend="ini.session.sid-length">session.sid_length</link></entry>
+ <entry>"32"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.3.0 起可用。</entry>
+ <entry>自 PHP 7.1.0 起有效。</entry>
</row>
<row>
- <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry>
+ <entry><link linkend="ini.session.sid-bits-per-character">session.sid_bits_per_character</link></entry>
+ <entry>"4"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 7.1.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.enabled">session.upload_progress.enabled</link></entry>
<entry>"1"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.cleanup">session.upload_progress.cleanup</link></entry>
+ <entry>"1"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.prefix">session.upload_progress.prefix</link></entry>
+ <entry>"upload_progress_"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.name">session.upload_progress.name</link></entry>
+ <entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.freq">session.upload_progress.freq</link></entry>
+ <entry>"1%"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.upload-progress.min-freq">session.upload_progress.min_freq</link></entry>
+ <entry>"1"</entry>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>自 PHP 5.4.0 起有效。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.lazy-write">session.lazy_write</link></entry>
+ <entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.3.0 起可用。</entry>
+ <entry>自 PHP 7.0.0 起有效。</entry>
</row>
<row>
+ <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
+ <entry>"a=href,area=href,frame=src,form="</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 7.1.0 起，session 功能不再使用此选项。</entry>
+ </row>
+ <row>
<entry><link linkend="ini.session.hash-function">session.hash_function</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 5.0.0 起可用。</entry>
+ <entry>自 PHP 7.1.0 起移除。</entry>
</row>
<row>
<entry><link linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character</link></entry>
<entry>"4"</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 5.0.0 起可用。</entry>
+ <entry>自 PHP 7.1.0 起移除。</entry>
</row>
<row>
- <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
- <entry>"a=href,area=href,frame=src,form=,fieldset="</entry>
+ <entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry>
+ <entry>""</entry>
<entry>PHP_INI_ALL</entry>
- <entry>自 PHP 4.0.4 起可用。</entry>
+ <entry>自 PHP 7.1.0 起移除。</entry>
</row>
-
<row>
- <entry><link linkend="ini.session.upload-progress.enabled">session.upload_progress.enabled</link></entry>
- <entry>"1"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.upload-progress.cleanup">session.upload_progress.cleanup</link></entry>
- <entry>"1"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.upload-progress.prefix">session.upload_progress.prefix</link></entry>
- <entry>"upload_progress_"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.upload-progress.name">session.upload_progress.name</link></entry>
- <entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.upload-progress.freq">session.upload_progress.freq</link></entry>
- <entry>"1%"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.upload-progress.min-freq">session.upload_progress.min_freq</link></entry>
- <entry>"1"</entry>
- <entry>PHP_INI_PERDIR</entry>
- <entry>Available since PHP 5.4.0.</entry>
- </row>
- <row>
- <entry><link linkend="ini.session.lazy-write">session.lazy_write</link></entry>
- <entry>"1"</entry>
- <entry>PHP_INI_ALL</entry>
- <entry>Available since PHP 7.0.0.</entry>
- </row>
+ <entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 7.1.0 起移除。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry>
+ <entry>"1"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 5.4.0 起移除。</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry>
+ <entry>"1"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>自 PHP 5.4.0 起移除。</entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -501,7 +530,7 @@
<simpara>
<literal>session.use_only_cookies</literal> 指定是否在客户端<emphasis
role="strong">仅仅</emphasis>使用 cookie 来存放会话 ID。。启用此设定可以防止有关通过
- URL 传递会话 ID 的攻击。此设定是 PHP 4.3.0 添加的。自PHP 5.3.0开始，默认值改为<literal>1</literal>（启用）
+ URL 传递会话 ID 的攻击。自PHP 5.3.0开始，默认值为<literal>1</literal>（启用）
</simpara>
</listitem>
</varlistentry>
@@ -590,6 +619,27 @@
</listitem>
</varlistentry>
+ <varlistentry xml:id="ini.session.cookie-samesite">
+ <term>
+ <parameter>session.cookie_samesite</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <simpara>
+ Allows servers to assert that a cookie ought not to be sent along with
+ cross-site requests. This assertion allows user agents to mitigate the risk
+ of cross-origin information leakage, and provides some protection against
+ cross-site request forgery attacks. Note that this is not supported by all
+ browsers.
+ An empty value means that no SameSite cookie attribute will be set.
+ <literal>Lax</literal> and <literal>Strict</literal> mean that the cookie
+ will not be sent cross-domain for POST requests; <literal>Lax</literal>
+ will sent the cookie for cross-domain GET requests, while <literal>Strict</literal>
+ will not.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
<varlistentry xml:id="ini.session.cache-limiter">
<term>
<parameter>session.cache_limiter</parameter>
@@ -636,11 +686,15 @@
email 将一个包含有效的会话 ID 的 URL 发给他的朋友，或者用户总是有可能在收藏夹中存有一个包含会话
ID 的 URL 来以同样的会话 ID 去访问站点。
</simpara>
+ <simpara>
+ 自 PHP 7.1.0 开始，透明 SID 开始使用完整的 URL 绝对路径，例如 https://php.net/。
+ 在此之前 PHP 只会使用相对路径。使用 <link
+ linkend="ini.session.trans-sid-hosts">session.trans_sid_hosts</link> 定义重写的目标 host。
+ </simpara>
</note>
</listitem>
</varlistentry>
-
-
+
<varlistentry xml:id="ini.session.trans-sid-tags">
<term>
<parameter>session.trans_sid_tags</parameter>
@@ -666,7 +720,7 @@
</note>
</listitem>
</varlistentry>
-
+
<varlistentry xml:id="ini.session.trans-sid-hosts">
<term>
<parameter>session.trans_sid_hosts</parameter>
@@ -697,6 +751,11 @@
<link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link>
时发出警告。此特性／错误可以通过关闭此选项而禁用。
</simpara>
+ <note>
+ <simpara>
+ PHP 5.4.0 中已经移除。
+ </simpara>
+ </note>
</listitem>
</varlistentry>
@@ -715,9 +774,14 @@
<link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link>
时发出警告。
</simpara>
+ <note>
+ <simpara>
+ PHP 5.4.0 中已经移除。
+ </simpara>
+ </note>
</listitem>
</varlistentry>
-
+
<varlistentry xml:id="ini.session.sid-length">
<term>
<parameter>session.sid_length</parameter>
@@ -732,23 +796,25 @@
<simpara>
The default is 32. If you need compatibility you may specify 32,
40, etc. Longer session ID is harder to guess. At least 32 chars
- is recommended.
+ are recommended.
</simpara>
- <para>
- Compatibility Note: Use 32 for
- <literal>session.hash_func</literal>=0 (MD5) and
+ <tip>
+ <para>
+ Compatibility Note: Use 32 instead of
+ <literal>session.hash_function</literal>=0 (MD5) and
<literal>session.hash_bits_per_character</literal>=4,
- <literal>session.hash_func</literal>=1 (SHA1) and
- <literal>session.hash_bits_per_character</literal>=6. Use 26 for
- <literal>session.hash_func</literal>=0 (MD5) and
- <literal>session.hash_bits_per_character</literal>=5. Use 22 for
- <literal>session.hash_func</literal>=0 (MD5) and
+ <literal>session.hash_function</literal>=1 (SHA1) and
+ <literal>session.hash_bits_per_character</literal>=6. Use 26 instead of
+ <literal>session.hash_function</literal>=0 (MD5) and
+ <literal>session.hash_bits_per_character</literal>=5. Use 22 instead of
+ <literal>session.hash_function</literal>=0 (MD5) and
<literal>session.hash_bits_per_character</literal>=6. You must
configure INI values to have at least 128 bits in session ID. Do
- not forget set appropriate value to
+ not forget to set an appropriate value for
<literal>session.sid_bits_per_character</literal>, otherwise you
will have weaker session ID.
- </para>
+ </para>
+ </tip>
<note>
<simpara>
This setting is introduced in PHP 7.1.0.
@@ -782,6 +848,27 @@
</listitem>
</varlistentry>
+
+ <varlistentry xml:id="ini.url-rewriter.tags">
+ <term>
+ <parameter>url_rewriter.tags</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <simpara>
+ <literal>url_rewriter.tags</literal> 指定在使用透明 SID 支持时哪些 HTML
+ 标记会被修改以加入会话 ID。默认为
+ <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal>。
+ </simpara>
+ <note>
+ <simpara>
+ 如果要符合 XHTML，去掉 <literal>form</literal> 项并在表单字段前后加上
+ <fieldset> 标记。
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+
<varlistentry xml:id="ini.session.hash-function">
<term>
<parameter>session.hash_function</parameter>
@@ -826,26 +913,6 @@
</listitem>
</varlistentry>
- <varlistentry xml:id="ini.url-rewriter.tags">
- <term>
- <parameter>url_rewriter.tags</parameter>
- <type>string</type>
- </term>
- <listitem>
- <simpara>
- <literal>url_rewriter.tags</literal> 指定在使用透明 SID 支持时哪些 HTML
- 标记会被修改以加入会话 ID。默认为
- <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal>。
- </simpara>
- <note>
- <simpara>
- 如果要符合 XHTML，去掉 <literal>form</literal> 项并在表单字段前后加上
- <fieldset> 标记。
- </simpara>
- </note>
- </listitem>
- </varlistentry>
-
<varlistentry xml:id="ini.session.upload-progress.enabled">
<term>
<parameter>session.upload_progress.enabled</parameter>