Reorder alphabetically.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@325329 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Derick Rethans 2012-04-19 08:45:42 +00:00
parent 6813e1ec5a
commit eba5076625

View file

@ -16,32 +16,17 @@
</thead>
<tbody>
<row>
<entry><link linkend="ini.mongo.native-long">mongo.native_long</link></entry>
<entry>false<link linkend="ini.mongo.native-long">*</link></entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.long-as-object">mongo.long_as_object</link></entry>
<entry><link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link></entry>
<entry>false</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.default-host">mongo.default_host</link></entry>
<entry>"localhost"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.default-port">mongo.default_port</link></entry>
<entry>27017</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.auto-reconnect">mongo.auto_reconnect</link></entry>
<entry><link linkend="ini.mongo.allow-persistent">mongo.allow_persistent</link></entry>
<entry>true</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry><link linkend="ini.mongo.allow-persistent">mongo.allow_persistent</link></entry>
<entry><link linkend="ini.mongo.auto-reconnect">mongo.auto_reconnect</link></entry>
<entry>true</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
@ -56,15 +41,30 @@
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.utf8">mongo.utf8</link></entry>
<entry>"1"</entry>
<entry><link linkend="ini.mongo.default-host">mongo.default_host</link></entry>
<entry>"localhost"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link></entry>
<entry><link linkend="ini.mongo.default-port">mongo.default_port</link></entry>
<entry>27017</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.long-as-object">mongo.long_as_object</link></entry>
<entry>false</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.native-long">mongo.native_long</link></entry>
<entry>false<link linkend="ini.mongo.native-long">*</link></entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry><link linkend="ini.mongo.utf8">mongo.utf8</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
</row>
</tbody>
</tgroup>
</table>
@ -75,94 +75,23 @@
<para>
<variablelist>
<varlistentry xml:id="ini.mongo.native-long">
<varlistentry xml:id="ini.mongo.allow-empty-keys">
<term>
<parameter>mongo.native-long</parameter>
<parameter>mongo.allow_empty_keys</parameter>
<type>int</type>
</term>
<listitem>
<para>
<emphasis>
The default behavior for this will be changed to &true; in 2.0.0, so make
sure to set this variable to the value you want (probably &true;) so that
the driver's behavior doesn't suddenly change when you upgrade.
</emphasis>
Added in version 1.0.11.
</para>
<para>
On 64-bit platforms, the <literal>mongo.native_long</literal> setting
allows for 64-bit integers to be stored in MongoDB. If it is not set, only
32-bits of the integer will be saved. The MongoDB data type that is used
in this case is the BSON LONG, instead of the BSON INT that is used if
this setting is turned off.
</para>
<para>
The setting also changes the way how BSON LONGs behave when they are read
back from MongoDB. Without <literal>mongo.native_long</literal> enabled,
the driver would convert every BSON LONG to a PHP double which can result
in a loss of precision.
</para>
<para>
On 32-bit platforms, the <literal>mongo.native_log</literal> setting
changes nothing for storing integers in MongoDB: the integer is stored
as a BSON INT as before. However, when the setting is enabled and a
BSON LONG is read from MongoDB a
<classname>MongoCursorException</classname> is thrown alerting you that
the data could not be read back without losing precision.
</para>
<para>
On 32-bit systems especially, it is recommended that you combine this with
enabling <literal>mongo.long_as_object</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.long-as-object">
<term>
<parameter>mongo.long_as_object</parameter>
<type>string</type>
</term>
<listitem>
<para>
Return a BSON_LONG as an instance of <classname>MongoInt64</classname>
(instead of a primitive type).
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.default-host">
<term>
<parameter>mongo.default_host</parameter>
<type>string</type>
</term>
<listitem>
<para>
Default hostname when nothing is passed to the constructor.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.default-port">
<term>
<parameter>mongo.default_port</parameter>
<type>string</type>
</term>
<listitem>
<para>
The default TCP port number to use when connecting to the database server
if no other port is specified. The database's default is
<literal>27017</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.auto-reconnect">
<term>
<parameter>mongo.auto_reconnect</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Whether to reconnect to the database if the connection is lost.
If empty strings ("") should be allowed as key names. By default, the
driver will throw an exception if you attempt to pass the empty string as
a key to the database. It is extremely easy to do this inavertently by
using double quotes with $-operators, so it is recommended that you leave
this setting as default. However, if you need to save keys that are empty
strings, you can set this option to true and the driver will allow you to
pass empty strings to the database.
</para>
</listitem>
</varlistentry>
@ -179,6 +108,18 @@
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.auto-reconnect">
<term>
<parameter>mongo.auto_reconnect</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Whether to reconnect to the database if the connection is lost.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.chunk-size">
<term>
<parameter>mongo.chunk_size</parameter>
@ -232,6 +173,86 @@ $query = array( "i" => array( ":gt" => 20, ":lte" => 30 ) );
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.default-host">
<term>
<parameter>mongo.default_host</parameter>
<type>string</type>
</term>
<listitem>
<para>
Default hostname when nothing is passed to the constructor.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.default-port">
<term>
<parameter>mongo.default_port</parameter>
<type>string</type>
</term>
<listitem>
<para>
The default TCP port number to use when connecting to the database server
if no other port is specified. The database's default is
<literal>27017</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.long-as-object">
<term>
<parameter>mongo.long_as_object</parameter>
<type>string</type>
</term>
<listitem>
<para>
Return a BSON_LONG as an instance of <classname>MongoInt64</classname>
(instead of a primitive type).
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.native-long">
<term>
<parameter>mongo.native-long</parameter>
<type>int</type>
</term>
<listitem>
<para>
<emphasis>
The default behavior for this will be changed to &true; in 2.0.0, so make
sure to set this variable to the value you want (probably &true;) so that
the driver's behavior doesn't suddenly change when you upgrade.
</emphasis>
</para>
<para>
On 64-bit platforms, the <literal>mongo.native_long</literal> setting
allows for 64-bit integers to be stored in MongoDB. If it is not set, only
32-bits of the integer will be saved. The MongoDB data type that is used
in this case is the BSON LONG, instead of the BSON INT that is used if
this setting is turned off.
</para>
<para>
The setting also changes the way how BSON LONGs behave when they are read
back from MongoDB. Without <literal>mongo.native_long</literal> enabled,
the driver would convert every BSON LONG to a PHP double which can result
in a loss of precision.
</para>
<para>
On 32-bit platforms, the <literal>mongo.native_log</literal> setting
changes nothing for storing integers in MongoDB: the integer is stored
as a BSON INT as before. However, when the setting is enabled and a
BSON LONG is read from MongoDB a
<classname>MongoCursorException</classname> is thrown alerting you that
the data could not be read back without losing precision.
</para>
<para>
On 32-bit systems especially, it is recommended that you combine this with
enabling <literal>mongo.long_as_object</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.utf8">
<term>
<parameter>mongo.utf8</parameter>
@ -251,27 +272,6 @@ $query = array( "i" => array( ":gt" => 20, ":lte" => 30 ) );
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mongo.allow-empty-keys">
<term>
<parameter>mongo.allow_empty_keys</parameter>
<type>int</type>
</term>
<listitem>
<para>
Added in version 1.0.11.
</para>
<para>
If empty strings ("") should be allowed as key names. By default, the
driver will throw an exception if you attempt to pass the empty string as
a key to the database. It is extremely easy to do this inavertently by
using double quotes with $-operators, so it is recommended that you leave
this setting as default. However, if you need to save keys that are empty
strings, you can set this option to true and the driver will allow you to
pass empty strings to the database.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>