svn: /phpdoc/zh/trunk/reference/session/ ini.xml
| From: | Dai Jie | Date: | Fri, 02 Jun 2017 12:44:14 +0000 |
| Subject: | svn: /phpdoc/zh/trunk/reference/session/ ini.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-4964@lists.php.net to get a copy of this message | ||
daijie Fri, 02 Jun 2017 12:44:14 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=342535
Log:
fixed
Changed paths:
U phpdoc/zh/trunk/reference/session/ini.xml
Modified: phpdoc/zh/trunk/reference/session/ini.xml
===================================================================
--- phpdoc/zh/trunk/reference/session/ini.xml 2017-06-02 10:07:34 UTC (rev 342534)
+++ phpdoc/zh/trunk/reference/session/ini.xml 2017-06-02 12:44:14 UTC (rev 342535)
@@ -640,6 +640,49 @@
</listitem>
</varlistentry>
+
+ <varlistentry xml:id="ini.session.trans-sid-tags">
+ <term>
+ <parameter>session.trans_sid_tags</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <simpara>
+ <literal>session.trans_sid_tags</literal> specifies which HTML tags
+ are rewritten to include session id when transparent sid support
+ is enabled. Defaults to
+ <literal>a=href,area=href,frame=src,input=src,form=</literal>
+ </simpara>
+ <simpara>
+ <literal>form</literal> is special tag. <literal><input
hidden="session_id" name="session_name"></literal>
+ is added as form variable.
+ </simpara>
+ <note>
+ <simpara>
+ Before PHP 7.1.0, <link
linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
+ was used for this purpose. Since PHP 7.1.0, <literal>fieldset</literal>
+ is no longer considered as special tag.
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry xml:id="ini.session.trans-sid-hosts">
+ <term>
+ <parameter>session.trans_sid_hosts</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <simpara>
+ <literal>session.trans_sid_hosts</literal> specifies which hosts
+ are rewritten to include session id when transparent sid support
+ is enabled. Defaults to <literal>$_SERVER['HTTP_HOST']</literal>
+ Multiple hosts can be specified by ",", no space is allowed
+ between hosts. e.g. <literal>php.net,wiki.php.net,bugs.php.net</literal>
+ </simpara>
+ </listitem>
+ </varlistentry>
+
<varlistentry xml:id="ini.session.bug-compat-42">
<term>
<parameter>session.bug_compat_42</parameter>
@@ -674,7 +717,71 @@
</simpara>
</listitem>
</varlistentry>
+
+ <varlistentry xml:id="ini.session.sid-length">
+ <term>
+ <parameter>session.sid_length</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <simpara>
+ <literal>session.sid_length</literal> allows you to specify the
+ length of session ID string. Session ID length can be between 22
+ to 256.
+ </simpara>
+ <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.
+ </simpara>
+ <para>
+ Compatibility Note: Use 32 for
+ <literal>session.hash_func</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_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
+ <literal>session.sid_bits_per_character</literal>, otherwise you
+ will have weaker session ID.
+ </para>
+ <note>
+ <simpara>
+ This setting is introduced in PHP 7.1.0.
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="ini.session.sid-bits-per-character">
+ <term>
+ <parameter>session.sid_bits_per_character</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <simpara>
+ <literal>session.sid_per_character</literal> allows you to specify the
+ number of bits in encoded session ID character. The possible values are
+ '4' (0-9, a-f), '5' (0-9, a-v), and '6' (0-9, a-z, A-Z,
"-", ",").
+ </simpara>
+ <simpara>
+ The default is 4. The more bits results in stronger session ID. 5 is
+ recommended value for most environments.
+ </simpara>
+ <para>
+ </para>
+ <note>
+ <simpara>
+ This setting is introduced in PHP 7.1.0.
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+
<varlistentry xml:id="ini.session.hash-function">
<term>
<parameter>session.hash_function</parameter>